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PILOTARE LA 

VII A 

Non è mai stato così semplice 
grazie a Visual Basic. IM ET 



STRUMENTI Le librerie 
da importare nei tuoi progetti 






REFEREMCE La guida all'uso 

di metodi e proprietà per catturare 

il flusso delle immagini 

PRATICA Un'applicazione completa 
per acquisire un video e salvarlo sul disco 
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{{r INTERCETTA UN FASCIO DI LUCE CON LA TELECAMERA 
E REALIZZA IN C# UN GIOCO DI TIRO AL BERSAGLIO 



CASI DI STUDIO: BUSINESS 





LUNGHE ATTESE ADDIO! 

Connessione con la banca assente? Ecco il servizio da utilizzare 
per mettere le transazioni in coda e gestirle quando possibile 




CASI DI STUDIO: ASP.NET 



GRAFICA DINAMICA 

Crea pulsanti ed altri elementi "On Demand' 
prendendo le informazioni da un database 



VISUAL BASIC 6.0 



SQL SERVER 2005 

E LE STORED PROCEDURE 

Ecco come integrare i tuoi programmi 
con il nuovo DB di Microsoft 



ACE: IL MULTIPIATTAFORMA 
PER IL NETWORKING 

Sviluppa applicazioni per la rete 

che funzionano su tutti i sistemi operativi 
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.NET ADVANCED 



CONTROLLI 
PERSONALIZZATI 

Le tecniche per estendere 
Visual Studio con moduli 
fatti su misura per te 



USARE LE 
WXWIDGETS 

Le librerie grafiche per 
programmare con facilità 



GRAFICA 



SKELETAL 
ANIMATION 

Le tecniche per realizzare 
animazioni fluide e realistiche 
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BY EXAMPLE 



Gli esempi guidati per 
imparare un linguaggio 
in modo pratico 
e divertente 

C#, Visual Basic.NET 

• Come fare drag and drop da 
una datagridview ad un'altra 

• Come posso aggiungere 
un'immagine agli elementi 
di una combobox? 

Java 

• Come posso realizzare 
applicazioni multilingue? 



ALGORITMI DI ORDINAMENTO! 



I come funzionano 
e qual è il più adatto per risolvere i tuoi problemi 



gin 



e molti altri ancora all'interno.. 
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Mi è capitato, recentemente, di leggere su un 
noto forum dedicato alla programmazione un 
thread in cui in modo molto ironico si ripercorreva 
l'evoluzione dei tool di sviluppo. Nell'ambito di 
questo thread, veniva citato ioProgrammo come 
indispensabile compagno di viaggio per "formarsi" 
all'uso dei diversi strumenti che si sono alternati sul 
mercato. Ed in effetti il nostro scopo è sempre stato 
quello di voler fare in una certa misura "formazio- 
ne". Non possiamo che essere contenti di affermare 
che anche grazie al nostro contributo è nata una 
nuova classe di programmatori che, nel corso di 
quasi 10 anni, ha sostenuto il mercato dello svilup- 
po in Italia. Non vogliamo con questo dire che 
quanto c'è di buono nel settore dello sviluppo sia 
interamente merito nostro, ma sicuramente possia- 
mo gloriarci di aver dato e di voler continuare a 
dare il nostro contributo alla formazione. È in que- 
sto ambito che nasce la collaborazione con 
Microsoft che da tempo è impegnata nel diffondere 
le corrette tecniche di programmazione legate ai 
propri strumenti. Gli MSDN Webcast, sono le regi- 
strazioni fedeli degli eventi di formazione tenuti 



dagli esperti di Microsoft online . Sono tipicamente 
composti dalla riproduzione delle slide mostrate 
durante l'evento, accompagnate dal commento del 
relatore, oltre le slide ci sono varie sezione di demo 
che mostrano come utilizzare le varie teniche 
descritte. ioProgrammo ha voluto aggiungere ai 
propri contenuti quelli prodotti direttamente da 
MS. Lo scopo è quello di poter ancora contribuire a 
fare formazione mettendo nelle mani dei lettori 
uno strumento da consultare rapidamente dai 
nostri CD. Questo rappresenta per noi l'ennesimo 
passo verso una nuova frontiera, ovvero quella di 
voler rendere un po' più multimediale 
ioProgrammo che adesso può contare su un'infor- 
mazione cartacea approfondita e facilmente con- 
sultabile, un centro di riferimento su internet con il 
proprio forum http://forum.ioprogrammo.it per 
scambiare informazioni oppure porre domande, e 
adesso anche un contenuto multimediale impor- 
tante che come avrete occasione voi stessi di nota- 
re rappresenta uno strumento veramente comodo 
per apprendere le nuove tecniche. 

Fabio Farnesi ffarnesi@edmaster. it 
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All'inizio di ogni articolo, troverete un simbolo 
che indicherà la presenza di codice e/o software 
allegato, che saranno presenti sia sul CD (nella 
posizione di sempre \soft\codice\ e \soft\tools\) 
sia sul Web, all'indirizzo 



mmmmrfffffflìP http://cdrom.ioprogrammo.it. 



OCCHIO ALLA 
WEBCAM 






Crea in Visual Basic un'applicazione che 
gestisce il video 



■ ■■ - ; • • 






• teoria: le librerie da 
utilizzare per interfacciare 
VB con la telecamera 

• tecnica: come utilizzare 
Visual Studio per 
includere le dll giuste 



• pratica: un esempio 
completo da seguire 
passo passo 
per iniziare subito 




0f iffin. 
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Questo mese su ioProgrammo 



MICROSOFT MESSAGE QUEUE 

MSMQ è il servizio Windows che facilita la comunicazione asincrona 
fra applicazioni per tutti gli scenari in cui le parti possono essere 
irrangiungibili offline o lavorare a velocità diverse pag. 78 



GRAFICA 



Skeletal 
Animation P a g . 3 o 

Animadead è una libreria 
progettata e realizzata per 
consentire a qualunque 
applicazione di eseguire 
animazioni di figure 
tridimensionali con una 
tecnica che le rende 
particolarmente realistiche. 



Aggregatore di feed RSS 

per cellulari pag. 36 

Vedremo come progettare e sviluppare un 
aggregatore di contenuti pubblicati tramite 
feed RSS che potrà essere installato sui comu- 
ni telefoni cellulari moderni 

Visual Basic .NET e Grafica . . pag. 42 

Integrare grafica e dati dinamicamente nelle 
pagine Web utilizzando le funzioni grafiche 
del .NET Framework. vedremo come realizzare 
bottoni in fase di run time 



VISUAL BASIC 



SQL Server Express 2005 

e le stored procedure pag. 64 

Descriveremo come realizzare un'applicazione 
Client-Server multimediale che utilizza moduli 
di classe, Stored Procedure e un database 
Microsoft SQL Server Express. Ovviamente lo 
faremo utilizzando Visual Basic 6.0 



SISTEMA 



Creare controlli 

personalizzati con .NET pag. 72 

Nell'intricato mondo della sicurezza , Java 
usa un proprio standard facile e potente 
al tempo stesso. Realizziamo insieme 
un'applicazione che ne spiega principi e 
funzionalità 

MSMQ: overview architetturale pag. 78 

MSMQ è il servizio Windows che facilita 
la comunicazione asincrona fra appli- 
cazioni per tutti gli scenari in cui le parti 



possono essere irrangiungibili offline o 
lavorare a velocità diverse 

Un asso per il 

multipiattaforma pag. 84 

Con le librerie ACE è possibile realizzare 
in maniera estremamente semplice appli- 
cazioni che comunicano via rete. 
Windows o Linux non fa differenza! 
Vedremo come fare tutto senza difficoltà 



SISTEMA 



Sviluppare in C++ 
per Windows e 

LinUX pag. 88 

Alla scoperta di WxWidgets, 
una potente libreria che ci 
consente di creare 
applicazioni multipiattaforma 
in modo semplice e veloce. 
In questo numero lavoriamo 
con le caratteristiche avanzate 



SOLUZIONI 



Sorting, algoritmi avanzati pag. 109 

L'ordinamento dei dati è un'operazione che 
ricorre di frequente. Un algoritmo efficiente 
può quindi segnare la differenza tra una 
buona e una cattiva applicazione 



Gli allegati di ioProgrammo pag. 6 

// software in allegato alla rivista 

Il libro di ioProgrammo pag. 7 

// contenuto del libro in allegato alla rivista 

News pag. 12 

Le più importanti novità del mondo 
della programmazione 

ioProgrammo by Example pag. 42 

25 problemi risolti con gli esempi di codice rapido 
da copiare e incollare per tutti i linguaggi 

Software pag. 106 

/ contenuti del CD allegato ad ioProgrammo. 
Corredati spesso di tutorial e guida all'uso 



Biblioteca pag. 114 

/ migliori testi scelti ogni mese dalla redazione 
aiutarvi nella programmazione 

l. 



per 



C0VERST0RY 



Creiamo un 

gioco tiro 

al bersaglio P a g i 4 

Usiamo delle librerie 
OpenSource e la WebCam per 
realizzare un gioco completo 
divertente e pieno di sorprese 



c 



ioProgrammo by EXAMPLE 



.NET 

Come fare Drag 'n 'Drop da una 

DataGridView ad un'altra 48 

Come posso visualizzare l'icona associata 

ad un file? 56 

Come posso sapere se un numero è pari o 
dispari? 58 

C# 

Come posso aggiungere un'immagine agli 

elementi di una ComboBox? 52 

Come posso convertire HTML in testo ...54 
Che cosa vuol dire Casting? 55 

Java 

Come posso realizzare applicazioni 

multilingue con java? 59 

Come posso avere informazioni sulle classi 
caricate? 61 



QUALCHE CONSIGLIO UTILE 

I nostri articoli si sforzano di essere 
comprensibili a tutti coloro che ci 
seguono. Nel caso in cui abbiate 
difficoltà nel comprendere esattamente 
il senso di una spiegazione tecnica, è 
utile aprire il codice allegato all'articolo 
e seguire passo passo quanto viene 
spiegato tenendo d'occhio l'intero 
progetto. Spesso per questioni di spazio 
non possiamo inserire il codice nella 
sua interezza nel corpo dell'articolo. Ci 
limitiamo a inserire le parti necessarie 
alla stretta comprensione della tecnica. 
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C++ DEV C++ 4.9.9.2 

PHP DEV PHP 2.0.13 

PHP 5.1.2 

PHPMYADMIIU 2.8.0 
DELPHI LAZARUS 0.9.10 
C# SHARPDEVELOP 2.2.0 
JAVA J2SE1.5.0 UPDATE 6 
ECLIPSE 3.1.2 
TOOLS MRTG 2.13 
MYSQL 5.0.18 
WXWIDGETS 2.6.2 



Prodotti del mese 



Ace 

La librerìa multipiattaforma 
per la rete 

Di Ace ce ne parla in modo 
approfondito Alfredo Marroccelli 
nel bell'articolo contenuto in que- 
sto stesso numero di ioProgrammo. 
Si tratta di una libreria che fornisce 
al C++ uno strato d'astrazione 
verso il TCP/IP. In parole povere 
consente di programmare applica- 
zioni che fanno un uso estensivo 
delle risorse di rete, costruendo 
uno strato superiore che fa da 
interfaccia verso il sistema operati- 
vo. Questo garantisce la massima 
portabilità da un sistema all'altro. 
Di fatto in fase di programmazione 
sarà semplicemente necessario 
richiamare le funzioni e i metodi 
esposti da ACE, sarà poi compito 
della libreria interfacciare la parte 
programmativa con il sistema ope- 
rativo sottostante. Si rivela un utile 
strumento per il multipiattaforma 

[pag.106] 



Jasper 
Reports 1.2.0 

Una librerìa scrìtta In java per 
creare report personalizzati 

Una libreria scritta in java per 
creare report personalizzati. 
Una libreria per generare 
report in grado di inviare il 
proprio output allo schermo, 
alla stampante o addirittura a 
file in formato PDF, HTML, XLS, 
CSV e e XML. Interamente 
scritta in Java, può facilmente 
essere utilizzata in un infinità 
di applicazioni, per generare 
contenuti dinamici. Ne ab- 
biamo parlato approfondita- 
mente in quache numero pre- 
cedente di ioProgrammo, ma 
per l'interesse che il progetto 
riveste non mancheremo di 
riparlarne ancora con articoli 
che ne illustrano in dettaglio 
tutte le caratteristiche. 

[pag.106] 



OpenCV 



La librerìa multipiattaforma per la 
WebCam 

Ce ne parla a lungo Antonino Pa- 
nella, nell'articolo che questo me- 
se illustra come creare un pro- 
gramma di tiro al bersaglio. 
L'esempio è didattico, ma le OpenCV 
sono delle librerie opensource che 
consentono di gestire in modo ot- 
timale la webcam. Le applicazio- 
ni sono infinite, si va dal ricono- 
scimento facciale al motion de- 
tection e persino ad usi avanzati 
e futuristici come il riconoscimen- 
to del labiale. Si tratta di librerie 
estremamente potenti che con- 
sentono di lavorare con le imma- 
gini in modo sofisticato. 
Un primo esempio d'uso lo trova- 
te in questo numero, ma siamo 
convinti che voi stessi sarete in 
grado di suggerirci impieghi mol- 
to fantasioso di questo ottimo f ra- 
me work 

[pag.107] 



Prtg Traff ic 
Grapher 5.2.0.565 

Traffico sotto controllo 

Mrtg lo conoscete tutti, si tratta 
di un software estremamente 
preciso per determinare il consu- 
mo di banda, di processore, di 
memoria di un sistema. MRTG 
interroga una macchina usando 
il protocollo SNMP e questo ga- 
rantisce una resa ottimale . 
MRTG ha degli svantaggi. Si trat- 
ta di un'applicazione peri che 
non ha la stessa facilità di utiliz- 
zo di un'applicazione a finestre. 
Per gli utenti Windows c'è PRTG, 
che tramite una comoda GUI 
esporta tutte le funzionalità 
classiche di MRTG in modo co- 
modo e intuitivo, con tanto di 
grafici e report dettagliati. Molto 
utile. Senza dubbio un valido 
aiuto per chi deve tenere sotto 
controllo una rete, qualunque sia 
la sua dimensione 

[pag.107] 
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I contenuti del libro 



V 



Imparare JSP 



Le JSP, ovvero le Java Server Pages hanno 
apportato un considerevole contributo allo 
sviluppo di applicazioni Web sicure ed 
efficienti. Si tratta di una tecnica basata sul 
linguaggio Java che garantisce una 
straordinaria riusabilità e demanda le poliitiche 
di gestione e sicurezza ad un Application 
Server. L'utilizzo delle JSP in ambito business è 
ormai talmente consolidato da rappresentare 
uno standard. Ivan Venuti ci illustra le 
fondamenta della tecnologia per poi proseguire 
nella descrizione degli aspetti avanzati. Il libro 
è dedicato a chi vuole imparare, ma anche a 
chi avendo una conoscenza di base delle JSP ne 
vuole approfondire alcuni aspetti. 



la tecnologia da conoscere 

per sviluppare applicazioni web 

per le aziende 

Cosa sono le JSP e come funzionano 
Installazione di Tomcat e servizi di base 
Strutture predefinite e sintassi 
Aspetti avanzatip dai Tag a JDBC 



http://www.ioprogrammo.it 



Aprile 2006/7 ► 



I contenuti multimediali 



GLI ALLEGATI DI IOPROGRAMMO 



▼ Arrivano anche i video... 



In collaborazione con 
MSDN, Microsoft Developer 
Network, nasce una nuova 
iniziativa per consentire agli 
sviluppatori di migliorare le 
proprie conoscenze di svilup- 
po seguendo dei minicorsi 
d'aggiornamento seduti co- 
modamente davanti al pro- 
prio computer quando e co- 
me lo desiderano. I WebCast 
di MSDN rappresentano 
un'ottima opportunità per 
approfondire le tecnologie di 
sviluppo Microsoft. Si tratta 
di eventi online interattivi e 
gratuiti di 60/90 minuti tenu- 
ti dagli esperti in tecnologia 
Microsoft in collaborazione 
con i partner di formazione 



MSDN. ioProgrammo ha vo- 
luto fornire un ulteriore servi- 
zio ai programmatori ovvero 
quello di poter seguire i corsi 
di formazione indipendente- 
mente dalla programmazione 
reale con cui essi vengono 
tenuti Online. Avendoli a di- 
sposizione sul CDRom posso- 
no essere seguiti in un qua- 
lunque momento della gior- 
nata, e magari consultati per 
rivedere un passaggio poco 
chiaro o per ottenere infor- 
mazioni su una certa tecnica. 
Siamo ben lieti di aver dato 
luogo a quesa iniziativa in 
stretta collaborazione con 
Microsoft ed aspettiamo il 
vostro feedback. 



I VIDEOCORSI PER PROGRAMMARE BENE 

C WEBCAST 

^UFFICIALI MICROSOFT 



| GRATIS NEL CD "I CORSI DI FORMAZIONE" 
DA SEGUIRE COMODAMENTE SUL PC "**- 




VISUAL STUDIO.NET 

• Le guideline per sviluppare applicazioni ben strutturate 

• Le DEMO per usare subito le novità di Visual Basic.NET 

ASP.NET 2.0 

• L'architettura e i primi passi per programmare il web 

• Massimo riutilizzo con le Master Pages e i temi 

• Data Access e Object Binding, come usare i database 



INFORMAZIONI SU MSDN WEBCAST 

http://www.microsoft.it/msdn/webcast_msdn 
http://forum.ioprogrammo.it 



FAQ 



Cosa sono i Webcast MSDN? 

MSDN propone agli sviluppatori una serie di eventi gratui- 
ti online e interattivi che approfondiscono le principali 
tematiche relative allo sviluppo di applicazioni su tecnolo- 
gia Microsoft. Questa serie di "corsi" sono noti con il nome 
di Webcast MSDN 

Come è composto tipicamente 
un Webcast? 

Normalmente vengono illustrate una serie di Slide com- 
mentate da un relatore. A supporto di queste presentazio- 
ni vengono inserite delle Demo in presa diretta che 
mostrano dal vivo come usare gli strumenti oggetto del 
Webcast 

Come mai trovo riferimenti a chat 
o a strumenti che non ho disponibili 
nei WebCast allegati alla rivista? 

La natura dei WebCast è quella di essere seguiti OnLine in 
tempo reale. Durante queste presentazioni in diretta ven- 
gono utilizzati strumenti molto simili a quelli della forma- 
zione a distanza. In questa ottica è possibile porre doman- 
de in presa diretta al relatore oppure partecipare a son- 
daggi etc. I WebCast riprodotti nel CD di ioProgrammo, pur 
non perdendo nessun contenuto informativo, per la natura 



asincrona del supporto non possono godere dell'interazio- 
ne diretta con il relatore. 

Come mai trovo i WebCast 
su ioProgrammo 

Come sempre ioProgrammo cerca di fornire un servizio ai 
programmatori italiani. Abbiamo pensato che poter usu- 
fruire dei WebCast MSDN direttamente da CD rappresen- 
tasse un ottimo modo di formarsi comodamente a casa e 
nei tempi desiderati. Lo scopo tanto di ioProgrammo, 
quanto di Microsoft è infatti quello di supportare la comu- 
nità dei programmatori italiani con tutti gli strumenti pos- 
sibili. 

Su ioProgrammo troverò tutti 
WebCast di Microsoft? 

Ne troverai sicuramente una buona parte, tuttavia per loro 
natura i webcast di Microsoft vengono diffusi anche OnLine e 
possono essere seguiti previa iscrizione. L'indirizzo per saperne 
di più è: http://www.microsoft.it/msdn/webcast msdn . segna- 
lo nei tuoi bookmark. Non puoi mancare. 

L'iniziativa sarà ripetuta sui prossimi 
numeri? 

Sicuramente si. 
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PC A BASSO PREZZO 
PER LEIMOVO 

L enovo Group erede del comparto 
Hardware di IBM ha appena lancia- 
to sul mercato una serie di PC a costi 
veramente molto contenuti. In parti- 
colare sono previsti 349$ per un 
Desktop e 599$ per un laptop. La 
nuova linea di prodotti sarà divisa in 
due linee di produzioni, la C e la J la 
prima equipaggiata con processori 
Intel, la secondo con processori AMD. 
Lenovo in questo modo reagisce alla 
crescente offerta di Dell che proprio 
recentemente aveva ottenuto grandi 
successi proponendo sistemi dai costi 
veramente ridotti. Tutte e due le case 
puntano comunque sulla vendita 
OnLine che riduce notevolmente i 
costi dovuti alla distribuzione. 

WINDOWS 98 
E WINDOWS ME 
ADDIO 

così siamo giunti alla fine di un'epo- 
ca. Microsoft ha ufficialmente an- 
nunciato che dal 30 Giugno 2006 cesserà 
il supporto Windows 98 e Windows Mil- 
lennium. Il consiglio di MS è quello di 
migrare almeno a Windows XP. Se non 
ci impressiona il fatto che Windows ME 
sia stato lasciato infine abbandonato a 
se stesso, confessiamo che un minimo di 
riflessione è dovuta almeno a Windows 
98 che per anni è stato il glorioso porta- 
bandiera delle tecnologie MS e che an- 
cora oggi probabilmente fa girare un di- 
screto numero di processori. 

E 1 MISTERO 

SU ORIGAMIPROJECT 

ra le nuove registrazioni di domini in- 
_ ternazionali spicca questo origami- 
project.com, intestato addirittura ad Mi- 
crosoft Corporation. Al momento in cui scri- 
viamo visitando il sito si accede a un 1 ani- 
mazione in flash che proietta le seguen- 
ti voci: "Do you know me? - Do you know 
what i can do? 

and where i can go?" su cosa sia e cosa vo- 
glia rappresentare questo nuovo pro- 
getto di Microsoft è mistero fitto. 



WINDOWS VISTA 
FA SEI! 



darebbero sei le versioni programma- 
nte da Microsoft, basate sull'annun- 

ciata nuova release di Windows: nome 

in codice Vista. 
Tre di queste sarebbero progettate 
per soddisfare le esigenze degli 
utenti domestici, due per le aziende 
e una dedicata ai nuovi mercati. In 
particolare le sei versioni in questio- 
ne sono state indicate come: Vista 
Business, Vista Enterprise,Vista 
Home Basic, Vista Home Premium, 
Vista Ultimate, Vista Starter. Le due 
versioni Business ed Enterprise 
sarebbero pressoché identiche e 
destinate ad un utenza decisamente 
aziendale, equipaggiate con stru- 
menti pensati per aiutare l'utente a 
mantenere ordinata la presenza di 
documenti all'interno delle proprie 
macchine e nella lan aziendale, tut- 
tavia la versione Enterprise include- 
rebbe un supporto decisamente 
importante alla criptazione dei docu- 
menti. È quindi prevista una certa 
attenzione alla privacy e alla sicurez- 



za, temi che recentemente stanno 
muovendo e non di poco il mercato 
informatico. 

La versione Home Basic includerebbe 
invece soltanto strumenti semplifica- 
ti per coloro che utilizzano il PC per 
effettuare operazioni ordinarie come 
navigare su internet, leggere la 
posta oppure creare semplici docu- 
menti. E' prevista in questa versione 
una stoccata al nemico giurato: 
"Google", sembrerebbe infatti che 
sarà incluso uno strumento per la 
ricerca delle informazioni molto simi- 
le al Desktop Search Bar promosso 
dal rivale. Anche in questo caso il 
sistema manterrà un occhio di 
riguardo verso la sicurezza includen- 
do un firewall leggermente più sofi- 
sticato di quello attuale. Vista Home 
Premium manterrà tutte le caratteri- 
stiche della versione precedente ma 
sarà equipaggiata con una nuova 
interfaccia grafica chiamata Aero. 
Questa interfaccia è pensata per aiu- 
tare gli utenti nel gestire documenti 



ORACLE ACQUISTA 
SLEEPYCAT 



Oracle ha appena annunciato di ave- 
re acquisito SleepyCat, software 
che fino a ieri deteneva i diritti sul fa- 
moso DB. Berkeley DB. L'annuncio è 
importante in un panorama, quello dei 
database, sempre più mobile e carat- 
terizzato da una concorrenza spietata. 
L'acquisto di Berkeley DB rappresen- 
ta per Oracle la possibilità di fornire un 
prodotto performante, completo e uti- 
lizzabile anche a livello enterprise a 
prezzi decisamente contenuti. Le di- 
chiarazioni di Mike Olson CEO di Sleepy- 
cat Software sono significative: " Sia- 
mo molto entusiasti di poter portare il 
nostro prodotto sul mercato enterpri- 
se e di entrare a far parte di una delle 
maggiori compagnie nel settore dei DB 
al mondo. I prodotti di Sleepycat, la ba- 



se dei clienti e un modello di business 
ormai sperimentato coniugate alla lar- 
ga esperienza di Oracle oltre che ov- 
viamente alla tecnologia e alle risorse di 
questa compagnia, ci consentiranno di 
servire al meglio i nostri clienti e sup- 
portare maggiormente la community 
OpenSource". Secondo gli esperti il mer- 
cato dei database Embedded nel 2005 
ha raggiunto un fatturato di due mi- 
liardi di dollari e si prospetta che rag- 
giungere 3.2 milioni di dollari nel 2009. 
L'acquisto di SleepyCat diventa perciò 
strategicamente importante per Ora- 
cle che piazza un nuovo prodotto al- 
l'interno del mercato dei DB embed- 
ded e si proietta in pole position per di- 
ventare leader di questo crescente seg- 
mento anche in futuro. 
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dovrebbe includere alcuni strumenti per 
la masterizzazione e l'authoring dei 
cd/dvd. Una nota importante è relativa 
alla capacità di questa nuova versione di 
poter interagire con una console Xbox 
360. Infine Vista Ultimate e Vistar starter 
Kit rappresentano i due poli opposti del- 
l'emergente tecnologia, da un lato 
Ultimate conterrà tutti gli strumenti delle 
versioni business ed home condensate in 
un'unica installazione, viceversa la versio- 
ne Starter sarà un edizione limitata pen- 
sata per soddisfare le esigenze di paesi 
che non dispongono ancora di strumenti 
abbastanza potenti da poter gestire un 
sistema così complesso. 



SUN ORGANIZZA 
L'AJAX DAY 



Ajax è decisamente una tecnolo- 
gia che sta facendo parlare di se. 
La possibilità di aggiornare solo par- 
ti di una pagina dinamica senza do- 
ver ricorrere all'uso dei frame ma 
considerando ogni oggetto della pa- 
gina come un elemento a se stante, 
apre scenari innovativi nel campo 
dello sviluppo web. 
Sono in tanti a puntare su questa 
nuova tecnologia, ed anche se an- 
cora fa capolino specialmente nelle 
Intranet, mentre ancora sono pochi 
i siti web che sono stati convertiti, si 
intravede la possibilità di una rete 
decisamente diversa per il futuro. Di 
tutto questo è ben cosciente Sun che 
ha organizzato a Milano e a Roma 
per il sei e il sette Marzo una gior- 
nata di seminari tesa ad illustrare ap- 
punto le nuove tecnologie. Paralle- 
lamente all'introduzione alla nuova 
tecnologia, SUN illustra anche le ca- 
pacità di JAVA Studio Creator 2 in re- 
lazione proprio allo sviluppo di web 
application con AJAX. 
L'iniziativa si è rivelata sicuramente 
interessante, sia per coloro che non 



utilizzano strumenti legati a Java ma 
che vogliono imparare a usare AJAX 
sia per coloro che sono già esperti di 
tecnologie SUN e vogliono ap- 
profondire il legame con strumenti 
avanzati quali Studio Creator 2. In 
ogni caso è da apprezzare lo sforzo 
di Sun nel volere sempre adottare le 
tecnologie più utili e innovative per 
gli sviluppatori 




YAHOO LANCIA IL PHP CENTER 



Yahoo è fra le prime grandi 
compagnie ad offrire uno 
spazio /community per PHP E' 
recente infatti l'annuncio del- 
l'apertura di una sezione del 
portale di Yahoo proprio dedi- 



cata a PHP. L'indirizzo è 
http: / / developer.yahoo.net/ph 
p. Questo nuovo spazio assu- 
merà la forma di una commu- 
nity. Nelle dichiarazioni di 
Jeffery Mcmanus la motivazio- 



ne appare forte e delicata, 
ovvero quella di offrire una 
piattaforma universale per lo 
sviluppo di applicazioni che 
possano in qualche modo 
essere integrate con i servizi già 



offerti dal l'azienda fondata dai 
due ragazzi terribili David Filo 
e Jerry Yang. Il legame fra PHP e 
Yahoo è d'altra parte noto. Fra i 
dipendenti di yahoo si conta 
anche Rasmus Lerdorf. 



MYSQL COMPRA NETFRASTRUCTURE INC 



E proprio il mercato dei database a far- 
la da padrone nell'intricato mondo del- 
lo sviluppo in questo inizio di 2006, così 
mentre Oracle si lancia alla conquista del 
mercato embededd, arriva l'annuncio di 
MySQL AB sempre più leader nel segmento 
Web. MySQL ha appena questiato Net- 
frastructure INC. Una software house suf- 



ficientemente piccola ma con una grande 
esperienza proprio nello sviluppo di Web 
Application, e che tra i suoi fondatori an- 
novera un nome importante per quanto 
riguarda la programmazione di architet- 
ture di database, ovvero JIM Starkey, per- 
sonaggio piuttosto noto in questo setto- 
re. In particare Starkey e la Netfrastrucu- 



re INC. avrebbero fornito un certo impul- 
so allo sviluppo di Interbase e Firebird. Il pri- 
mo dei due prodotti è finito poi nelle ma- 
ni di Borland, il secondo ha continuato ad 
essere sviluppato in modo Free. In tutti e 
due i casi i database in questione hanno ap- 
portato innovazioni significative in que- 
sto settore. 
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CREIAMO UN GIOCO: 
TIRO AL BERSAGLIO 

GRAZIE AL RILASCIO DELLA SUA LIBRERIA OPEN SOURCE COMPUTER VISION LIBRARY 
(OPENCV), INTEL CORPORATION HA ACCELERATO LO SVILUPPO DI APPLICAZIONI IN 
GRADO DI SFRUTTARE LA WEBCAM. VEDIAMO COME. 
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n questo articolo ci divertiremo a creare 
un piccolo gioco di tiro al bersaglio elet- 
tronico. Il funzionamento sarà semplice. 
Avremo bisogno di un foglio di carta su cui 
stampare sette cerchi concentrici e che rap- 
presenterà il nostro bersaglio, di una web- 
cam da posizionare dietro il bersaglio, e di un 
puntatore laser. Niente paura, il puntatore la- 
ser può essere tranquillamente una di quelle 
luci a fascio stretto che viene utilizzata spes- 
so come portachiave. Volendo divertirvi 
potete anche usare un semplice condensato- 
re per rendere l'effetto molto simile a quello 
ottenuto da una pistola laser. 
Il funzionamento tecnico del gioco è abba- 
stanza semplice. L'utente spara verso il ber- 
saglio con il laser, la webcam posta dietro il 
bersaglio intercetta il fascio di luce e attribui- 
sce un punteggio basato sulla precisione del 
tiro sul bersagno. 



COME FARE? 

Utilizzeremo una libreria sviluppata da Intel 
Corporation sotto licenza OpenSource, la 
OpenCv sufficientemente potente per aiutar- 
ci al raggiungimento dei nostri scopi. Il codi- 
ce sorgente di tutte le funzioni contenute 
nella libreria sono scritte in C e la ridistribu- 
zione del codice sorgente è priva di royalty. 
L'utilità di questa libreria è innegabile nel 
campo dell'aiuto ai disabili o per migliorare 
l'interazione uomo-macchina. Ma può essere 
usata anche per impieghi, come dire, più 
"ludici". 

Possiamo pensare di realizzare su di essa 
un'applicazione con la quale calcolare il pun- 
teggio di ogni tiro al target, analizzando il 
flusso video prodotto dalla videocamera digi- 
tale per individuare con una buona approssi- 
mazione dentro quale cerchio sta ricadendo 
il punto del laser. In sostanza, per realizzare 



questo tiro al bersaglio abbiamo bisogno di 
uno strato software, che svolga la funzione 
elaborativa di cui spiegheremo i principi di 
funzionamento, e un po' di hardware vera- 
mente comune che non richiede una spesa 
da capogiro: una webcam via USB a bassa 
risoluzione (320x120 a 15 €) e un laser di 
quelli che si acquistano dagli ambulanti per 
strada (7-10 €). Totale 22-25 €. 
Naturalmente bisogna aggiungere il "target", 
il disegno di un certo numero di cerchi con- 
centrici. 



ANALISI 

Preso così il compito che ci siamo prefissati è 
veramente arduo a causa del numero di va- 
riabili che dovremmo prendere in considera- 
zione; le principali sono: la posizione della 
webcam rispetto all'obiettivo, il calcolo della 
rotazione degli assi visivi, la diversa lumino- 
sità del laser e della dimensione del punto 
prodotto. 

Per semplificare il progetto partiamo da due 
semplici ipotesi: 

• il target è prefissato: è costituito da 7 cer- 
chi cerchi concentrici dove, preso come ri- 
ferimento il raggio r del cerchio più picco- 
lo , il secondo cerchio è 2r, il terzo 3r e così 
via. 

• Il foglio su cui viene stampato il disegno 
viene appeso di fronte alla webcam in mo- 
do che sia abbastanza dritta. 

In generale individuiamo due macro attività, 
nella prima calibreremo la webcam in modo 
da individuare la posizione del disegno e ri- 
costruire su di esso il modello del target; la 
seconda avrà la funzione di catturare la pre- 
senza del punto luce del laser sull'obiettivo e 
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posizionarlo rispetto ai cerchi concentrici in 
modo da assegnare il giusto punteggio. 



FASE UNO: INDIVIDUARE 
IL MODELLO 

Dentro la distribuzione di OpenCv troviamo 
CvCam, un modulo universale e multi piat- 
taforma messo a disposizione dall'Intel per la 
gestione dei flussi video ottenuti attraverso 
l'uso di videocamere digitali. Essa è imple- 
mentata come una Dynamic Link Library 
(DLL) per le piattaforme Windows e come una 
Shared Object Library (so) per i sistemi Linux. 
CvCam fornisce un'interfaccia di funzioni 
(API) mediante le quali è possible leggere e 
controllare lo stream video, elaborare ogni 
singolo frame individuate all'interno del flus- 
so di dati e renderizzare il risultato di tale ela- 
borazione. Per semplificare un po' la mole di 
lavoro sfrutteremo quindi le funzionalità 
messe a disposizione da CvCam. In particola- 
re, utilizzeremo questo modulo per indivi- 
duare la webcam tra tutti i dispositivi collega- 
ti al computer e inizializzarla in modo da pre- 
pararla a fornirci le immagini riprese. Una 
volta pronta, dalla webcam possiamo recupe- 
rare direttamente lo stream video lavorando 
immagine per immagine. 



Select camera(s) 



jnjxj 



The main camera 



~3 



I - Second camera 



"3 



OK 




Cancel 



Fig. 1: Qui è possibile scegliere la webcam tra quelle individuate in maniera auto- 
matica 

"stereoscopiche", cioè dove è necessario l'uso di 
una coppia di telecamere per ricostruire un mo- 
dello reale di ciò che si sta riprendendo. L'impie- 
go di due videocamere digitali consente di otte- 
nere informazioni sulla profondità e sull'imma- 
gine altrimenti non possibile limitandoci ad una 
sola, in questo modo è possibile realizzare una 
vasta gamma di applicazioni di computer vi- 
sion, tra cui il riconoscimento gestuale, la regi- 
strazione di oggetti e il riconoscimento facciale. 
Ottenuta la scelta dell'utente si procede con l'i- 
nizializzazione della webcam 

int desi redca mera = out[0];//for example 



cvcamSetProperty(desiredcamera, 

CVCAM_PROP_ENABLE, CVCAMTRUE); 



INIZIALIZZARE 
LA WEBCAM 

La procedura di inizializzazione della Web- 
Cam è abbastanza semplice, anche perché 
ogni ingrato compito di interfacciamento con 
il dispositivo è delegato alla libreria OpenCV. 
Le istruzioni da richiamare sono veramente 
poche. La prima cosa da fare è ottenere il nu- 
mero di webcam collegate con il computer 

int numCamere=cvcamGetCamerasCount(); 

Verificata la presenza di almeno un dispositi- 
vo compatibile, si procede dando la possibili- 
tà all'utente di selezionare quale camera vuol 
utilizzare 

int* out; 

int nselected = cvcamSelectCamera(&out); 

usando cvcamSelectCameraO si aprirà una fi- 
nestra come quella mostrata in Figura 1. 
È possibile notare che OpenCv dà la possibi- 
lità di selezionare due diverse webcam. 
Questo perché la libreria è nata per applicazioni 



CvCapture* capture =cvCaptureFromCAM( out[0] ); 

A questo punto la webcam, virtualmente rap- 
presentata dall'entità capture, è pronta a ri- 
spondere ad ogni nostro comando. Possiamo 
vedere ad esempio come è possibile ottenere 
quello che sta riprendendo in un determinato 
istante: 

cvGrabFrame( capture ); 

Ipllmage* input_img= cvRetrieveFrame( capture ); 




iRI DIGITALI 



Tra le funzioni avanzate più 
frequentemente usate in Com- 
puter Vision ci sono i filtri 
digitali, il cui effetto è uguale 
a quello dei corrispondenti 
filtri ottici usati in fotografia. 
Le funzioni matematiche dei 
filtri digitali sono 
implementate usando la con- 
voluzione spaziale 3x3 dove il 
valore di ogni pixel è rimpiaz- 
zato con la media algebrica 



ponderata del suo valore e del 
valore degli 8 pixels adiacenti: 
i valori dei 9 pixels vengono 
moltiplicati per il valore dei 
corrispettivi pesi, poi viene 
eseguita la media il cui 
risultato va a sostituire il valo- 
re del pixel centrale. Questa 
operazione viene ripetuta per 
tutti i pixels dell'immagine o 
di un'area selezionata in cui si 
vuole eseguire il filtraggio. 
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FILTRO CANNY 

L'operatore Canny con- 
siste in un filtro digita- 
le di edge-detection 
sulle immagini digitali 
al fine di identificare 
ed estrarre dei profili 
dagli elementi scelti. Il 
profilo ricavato 
mediante tale tecnica 
viene poi usato per la 
registrazione di un'im- 
magine su un sistema 
di riferimento. L'uso di 
questo filtro è sempre 
il primo passo nelle 
operazioni di identifi- 
cazioni di oggetti e 
figure all'interno delle 
immagini. Queste 
devono prima essere 
sottoposte ad una fase 
di pre-elaborazione in 
modo da renderle 
adette all'applicazione 
dell'operatore Canny. 



La funzione cvGrabFrameO comanda il device 
a "scattare" un'istantanea di quello che sta 
riprendendo in quel preciso momento. Per 
poter ottenere l'immagine catturata si ricorre 
a cvRetrieveFrameO. Con pochi e semplici 
comandi abbiamo quindi preso il controllo 
della webcam. Dal flusso video vengono così 
isolate delle singole immagini su cui possia- 
mo adesso effettuare tutte le elaborazioni di 
cui abbiamo bisogno. Cominciamo con la 
calibratura della webcam, necessaria per indi- 
viduare la posizione del target sull'immagine 
e costruire su di essa il nostro modello. 



CENTRARE IL MODELLO 

Posizioniamo il device in modo da riprendere 
per intero il disegno a cerchi concentrici che 
costituisce il target da individuare. La calibra- 
tura consiste nel sottoporre ogni singola 
immagine ripresa ad una serie di elaborazio- 
ni il cui scopo è quello di individuare la pre- 
senza di figure geometriche il più possibile 
simili a cerchi. In generale basterebbe estrar- 
re il contorno dall'immagine (operazione tra 
l'altro molto semplice usando la funzione 
cvFindContoursO con opportuni parametri) e 
passarlo come ingresso a cvFitEllipse(). Beh, 
qui cominciamo ad incontrare le prime diffi- 
coltà. Infatti, non possiamo illuderci di riusci- 
re ad ottenere il ricalco del contorno di tutte 
le figure individuabili: le webcam di solito 
hanno una bassa risoluzione e sono molto 
sensibili alla variazione di luce, creando di 
fatto delle aree a diversa luminosità su cia- 
scuna immagine che non risulterà quindi 
omogenea. In altre parole ogni frame è sog- 
getto ad una forte dose di disturbo che influi- 
sce in maniera molto significativa sul risulta- 
to della cvFindContoursO: se non mettessimo 
dei vincoli a questa operazione otterremmo 
anche il contorno di questi disturbi il che 




impedirebbe di fatto ogni elaborazione suc- 
cessiva. Dobbiamo cercare di eliminare que- 
sti "rumori di fondo" dall'immagine operan- 
do una serie di filtraggi. Per prima cosa con- 
vertiamo l'immagine a colori [Figura 2] por- 
tandola in toni di grigio [Figura 3], in modo 
da ridurre la quantità di informazioni da ela- 
borare; oltretutto l'utilizzo di ciascun canale 
di colore RGB darebbe soltanto risultati 
ridondanti. 

Ipllmage* input_img = ... 
IplImage*m_tmp8uClT=... 
cvCvtColor(input_img, m_tmp8uClT, 



CV_RGB2GRAY); 




Fig. 2: Questo è ciò che riprende la telecamera 



Fig. 3: L'immagine originale viene convertita in toni 
di grigio 



Come si può vedere, mettendo a confronto le 
due immagini, la seconda è ruotata di 180 gra- 
di, ma non è un problema, basta tenerne con- 
to nel proseguio. La funzione cvCvtColor() con- 
verte l'immagine in ingresso da uno spazio di co- 
lore ad un altro. Il primo parametro è l'imma- 
gine sorgente, il secondo è quella risultante la 
trasformazione mentre il terzo corrisponde al 
tipo di conversione da adottare. In particolare 
è il tipo di trasformazione è una costante inte- 
ra codificata come CV_<src_color_space>2 
<dst_color_space>. A questo punto l'immagi- 
ne è pronta per essere resa omogenea median- 
te un filtro di smooth: l'effetto è che l'immagi- 
ne viene come "piallata", le tonalità di grigio 
sfumati riducendo l'effetto macroblocco [Fi- 
gura 4] . 

cvSmooth( m_tmp8uClT, image05, CV_BLUR,3,3,0); 

Adesso applichiamo l'operatore Canny, il 
quale evidenzia ed isola il filo degli oggetti 
presenti sull'immagine [Fig. 5]; per capirci 
meglio, è un po' quello che facevamo da pic- 
coli quando mettevamo un foglio bianco so- 
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CvPoint2D32f* PointArray2D32f; 



stor = cvCreateMemStorage(O); 



Fig. 4: Si applica il filtro smooth per eliminare quel 
fastidioso effetto macroblocco 



pra un disegno e con una matita ricalcavamo 
i contorni che apparivano come un'ombra. 

cvCanny(m_tmp8uClT,image03, 50, 100, 3); 

l'algoritmo di Canny lavora su alcuni para- 
metri, giocando con questi valori si può ri- 
durre ulteriormente l'effetto del disturbo 
(che tra l'altro dipende dalla webcam). 



-1 -inlx 







Fig. 5: Risultato dopo l'operazione di Canny 

In image05 abbiamo finalmente un'immagi- 
ne accettabile, privata sostanzialmente da 
tutti i disturbi e contenente soltanto l'infor- 
mazione di cui avevamo bisogno, anche se in 
effetti è stata privata praticamente di tutto! 
Soltanto una cosa è stata risparmiata da que- 
sto filtraggio aggressivo sull'immagine cattu- 
rata dalla webcam: il cerchio centrale del tar- 
get, quello tutto nero. Il passo successivo 
adesso è quello di estrarre il contorno, me- 
diante cvFindContoursO, dall'immagine così 
ottenuta 

CvMemStorage* stor; 
CvSeq* cont; 
CvBox2D32f* box; 
CvPoint* PointArray; 



cont = cvCreateSeq(CV_SEQ_ELTYPE_POINT, 

sizeof(CvSeq), sizeof(CvPoint) , stor); 

cvFindContours( image03, stor, &cont, 

sizeof(CvContour), CV_RETR_EXTERNAL, 

CV_CHAIN_APPROX_NONE); 

in cont c'è adesso tutta la sequenza di punti 
che individuano l'estremità dei segmenti che 
costituiscono il contorno in generale. La 
sequenza è in realtà suddivisa per blocchi, 
tenendo conto che il contorno individuato 
non è proprio perfetto e ci sono zone prive di 
informazioni necessarie per renderlo conti- 
nuo. Nonostante questo possiamo procedere 
lavorando per ciascun blocco, estraendo i 
punti che lo costituiscono e cercando l'even- 
tuale ellisse che li collega tutti mediante la 
funzione cvFitEllipse (). Per individuare cor- 
rettamente un ellisse sono necessati almento 
5 punti: per essere sicuri escluderemo tutti i 
blocchi con meno di 10 punti. 

for(;cont;cont = cont->h_next){ 
int i; 
//ritorna il numero totale di punti del blocco 



int count = cont->total; 



CvPoint center; 



CvSize size; 



doublé area, perimeter, roundness; 



if( count < 10 ) continue; 



// Allochiamo la memoria per contenere tutti i punti 
PointArray = (CvPoint*)malloc( 

count*sizeof(CvPoint) ); 
PointArray2D32f= (CvPoint2D32f*)malloc( 

count*sizeof(CvPoint2D32f) ); 

// Allochiamo la memoria che conterrà le 
informazioni relative al box 
box = (CvBox2D32f*)malloc(sizeof(CvBox2D32f)); 





HE COSA E IL TIPO SYSTEM. INTPTR 



È un tipo specifico per la 
piattaforma utilizzato per 
rappresentare un puntatore o 
un handle. IntPtr è progettato 
per essere un integer di una 
dimensione specifica per la 
piattaforma. È previsto che 
un'istanza di questo tipo sia a 
32 bit per hardware e sistemi 
operativi a 32 bit e a 64 bit per 
hardware e sistemi operativi a 
64 bit. È possibile utilizzare il 
tipo IntPtr in linguaggi che 
supportano i puntatori e come 



elemento comune per 
riferimenti ai dati in linguaggi 
che supportano i puntatori e in 
linguaggi che non li 
supportano. È inoltre possibile 
utilizzare gli oggetti IntPtr per 
contenere gli handle. Istanze di 
IntPtr, ad esempio, vengono 
spesso utilizzate nella classe 
System. IO. FileStream per 
contenere handle di file o nel 
nostro caso, per recuperare un 
bitmap in memoria generata 
tramite la di I. 
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cvCvtSeqToArray(cont, PointArray, 




IPLIMAGE 

Ipllmage (strano nome 
che sta a significare 
Image Processing 
Library - Image) è il 
formato standard 
usato nelle API IPL e 
OpenCV dell'Intel per 
rappresentare un'im- 
magine. Tramite que- 
sta struttura è possibi- 
le gestire completa- 
mente tutto ciò che 
riguarda le immagini: 
caricamento e salva- 
taggio da file di tutti i 
formati (jpeg, gif, tiff, 
etc), elaborazione e 
visualizzazione a fine- 
stra. 



CV_WHOLE_SEQ); 



for(i=0; i<count; i++) 



{ 



PointArray 2 D32f[i].x = (float)PointArray[i].x; 
PointArray2D32f[i].y = (float)PointArray[i].y; 



} 



//Come risultato da un box 



cvFitEllipse(PointArray2D32f, count, box); 

// Calculaliamo l'area e il perimetro 

area = cvContourArea(cont, CV_WHOLE_SEQ); 

perimeter = cvArcl_ength(cont, CV_WHOLE_SEQ, 



i); 



roundness = (4 * 3.14159 * area) / (perimeter * 

perimeter); 

center.x = cvRound(box->center.x); 

center.y = cvRound(box->center.y); 

size.width = cvRound(box->size.width*.5); 

size.height = cvRound(box->size.height*.5); 

box->angle = -box->angle; 

1. goes 
down to 0. 



if (roundness > .875) // perfect circle 



{if (size.width > 5) 



{ 



..//trovato! 

centro=center; 
raggio=max(size.width, size.height); 



} 



} 



Calcolando il perimetro del blocco individua- 
to e l'area, possiamo valutare se quello che 
abbiamo trovato è qualcosa di simile ad un 
cerchio calcolando il parametro Roundness, 
cioè il rapporto tra Tasse maggiore e quello 
minore dell'ellisse: se questo rapporto è 
uguale a 1, la figura è un cerchio perfetto, 
0.875 è un buon compromesso dato che per 
essere perfetto la webcam dovrebbe centrare 
esattamente il target. 

In fin dei conti era questo di cui avevamo 
bisogno, la posizione del centro (box->cen- 
ter) e il raggio "base" (metà del massimo tra i 
due lati del box) , cioè la distanza tra un anel- 
lo ed il successivo che per impostazione è 
sempre lo stesso. Sia dr il raggio del cerchio 
centrale, quello successivo sarà 2dr, il se- 
guente 3dr e così via. Il target è quindi com- 
pletamente individuato e modellizzato. Co- 
me abbiamo visto, una tecnica di ricerca così 
semplice richiede che la webcam sia centrata 
sul target per avere un risultato ottimale. Co- 
munque Terrore introdotto dalla posizione 
della videocamera può essere reso minimo 
spostandola finché il modello ricostruito sia 
il più vicino possibile con il target vero e pro- 



prio. Come fare? Basta visualizzare Timmagi- 
ne originale e disegnarci di sopra i modello a 
cerchi ricostruito! 

cvl\lamedWindow("Target",l); 

apre una finestra in cui visualizzare T immagi - 
ne 



for (int i = l; i< = 7; i ++) 


cvCircle(input_img, centro, P 


* raggio, 










CV_ 


_RGB(255 ( 


255 


,255), 


i); 


cvShowImage("Target", 


input 


jmg); 









FASE DUE: LA 
POSIZIONE DEL LASER 

Abbiamo il modello e quindi la prima ma- 
crooperazione è conclusa. Adesso è necessa- 
rio individuare la posizione del punto pro- 
dotto dal laser sul target. Beh, sfruttiamo la 
stessa tecnica adottata per la calibrazione, 
con un particolare in più. Perché? Beh, il pun- 
to è rilevabile come un cerchio e quindi 
basterebbe di nuovo trovare tutte le figure 
che più si avvicinano ad un cerchio. Ma come 
abbiamo visto c'è molto errore sull'immagine 
acquisita dalla webcam e comunque il punto 
del laser non è ben visibile, appare come un 
alone senza bordi netti. 

Come fare allora? Per prima cosa eliminiamo 
ogni movimento rilevabile intorno al model- 
lo ricostruito, isolando l'area dell'immagine 
occupata dal rettangolo che circoscrive il tar- 
get individuato. 

cvSetImageROI( image, cvRect(oldCenter.x- 

7*old Raggio, oldCenter.y-7*old Raggio, 
14*old Raggio, 14*old Raggio)); 




Fig. 6: Immagine di confronto 
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Istantanea che riprende il colpo del laser 



Fatto questo, mettiamo a confronto due di- 
verse immagini, la prima [Figura 6] che ri- 
prende il target senza il dot (punto del laser 
sul foglio) e l'altra con il dot [Figura 7]. 




Fig. 8: Differenza tra la Fig. 6 e la Fig. 7 

Possiamo evidenziare ed isolare la differenza 
tra le due istantanee [Figura 8] , che è proprio 
l'area dove ricade il dot se la webcam e il tar- 
get sono mantenuti fermi, 



DA IPLIMAGE A BITMAP 

L'IplImage è una struttura proprietaria 
dell'Intel per rappresentare i dati che costi- 
tuiscono un'immagine. Per poter consentire 
l'interoperabilità con altre applicazioni è pos- 
sibile rendere disponibile l'immagine in- 
capsulata nella Ipllmage senza troppo impe- 
gno. Possiamo infatti definire la funzione Ipl- 
ImageToHBitmapO che converta una Ipllma- 
ge passata in ingresso in una Bitmap (HBIT- 
MAP). 



HBITMAP IplImageToHBitmap(IplImage* image) 




{ 



HBITMAP hBitmap=CreateBitmap( 

image- >width,image->height,image 
->nChannels*8,l); 
long p=SetBitmapBits(hBitmap,image-> 

imageSize,image->imageData); 
return hBitmap; 



} 



OSA E UNA DLL 



DLL è l'acronimo di Dynamic 
Link Library ovvero in italiano 
Libreria a Collegamento 
Dinamico. Esse possono essere 
viste come una raccolta di 
funzioni richiamabili da 
qualsiasi programma in grado 
di interfacciarvisi. Di solito 
all'interno delle DLL si 
introducono delle istruzioni da 
condividere o di 
interfacciamento, consentendo 



così di non inserire codice 
duplicato in applicazioni 
differenti. 

Tramite le DLL è anche 
possibile esportare delle 
funzionalità sviluppate per un 
dato linguaggio di 
programmazione verso altri. Si 
possono assimilare le DLL 
come a unità che contengono 
codice eseguibile collegabile in 
fase di esecuzione. 



cvAbsDiff( oldlmage, imageB, imageRis ); 

e poi procedere per individuare il centro del- 
l'area riportandolo in coordinate relative al 
centro del modello ricostruito [Figura 9]. 




Tale funzione costruisce la bitmap tramite una 
chiamata al metodo CreateBitmapO usando i 
parametri della Ipllmage e vi copia dentro la 
sequenza di dati che la compongono 



HBITMAP CreateBitmap (int w,int h,WORD bpp,int 

nSize) 



{ 



HDC hDC = ::CreateCompatibleDC(0); 

BYTE tmp[sizeof(BITMAPINFO) + 255*4]; 

BITMAPINFO *bmi = (BITMAPINFO*)tmp; 

HBITMAP hBmp; 

int i; 

memset(bmi,0,sizeof(BITMAPINFO)); 
bmi->bmiHeader.biSize = 

sizeof(BITMAPINFOHEADER); 



bmi->bmiHeader.biWidth = w; 



Fig. 9: Dopo l'operazione di Canny. 



bmi->bmiHeader.biHeight = h; 
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bmi->bmiHeader.biPlanes = nSize; 



return img; 



bmi->bmiHeader.biBitCount = bpp; 




Per informazioni sulla 

libreria Intel OpenCV 

fare riferimento al sito 

web ufficiale: 

http://www.intel.com 

/technology/computing 

/opencv/index.htm 



bmi->bmiHeader.biCompression = BI_RGB; 
bmi->bmiHeader.biSizeImage = w*h*l; 
bmi->bmiHeader.biClrImportant =0 ; 
switch(bpp) 
{ 
case 8 : 

for(i=0 ; i < 256 ; i ++) 
{ 

bmi->bmiColors[i].rgbBlue = i; 
bmi->bmiColors[i].rgbGreen= i; 
bmi->bmiColors[i].rgbRed= i; 

} 

break; 

case 32: 

case 24: 

((DWORD*) bmi->bmiColors)[0] = OxOOFFOOOO; /* 

componente rossa*/ 
((DWORD*) bmi->bmiColors)[l] = OxOOOOFFOO; /* 

componente verde*/ 
((DWORD*) bmi->bmiColors)[2] = OxOOOOOOFF; /* 

componente blu*/ 
break; 

> 

hBmp =::CreateDIBSection( 

hDC,bmi,DIB_RGB_COLORS,NULL,0,0); 

::DeleteDC(hDC); 

return hBmp; 



In maniera analoga possiamo procedure per 
ottenere una Ipllmage a partire da una HBIT- 
MAP 



Questa funzione recupera l'oggetto BITMAP 
rappresentato dall' HBITMAP, costruisce una 
entità Ipllmage e vi copia dentro la sequenza 
di bit che costituisce l'immagine. 



CAMLIBRARY 

Per semplificare l'interfacciamento con la li- 
breria OpenCV costruiremo una dll con Vi- 
sual C++ (vedi box) con la quale metteremo a 
disposizione una serie di comandi per agire 
sul device e per recuperare le informazioni 
dall'immagini via via prodotte. 

bool InitCameraO: inizializza la webcam 
bool GrabFrame(): effettua uno scatto 
HBITMAP RetriveFrameO: ritorna l'indi- 
rizzo della bitmap 

bool Find_Circles(): cerca il centro e ritor- 
na il modello 

bool Find_Shot(): determina la presenza e 
la posizione del dot 

int Centro_X(): ritorna la coordinata X del 
centro del modello 

int Centro_Y(): ritorna la coordinata Y del 
centro del modello 

int Centro_R() : è il raggio base del model- 
lo a cerchi 

int Shot_X(): la coordinata X del dot 
int Shot_Y(): la coordinata Y del dot 



Ipllmage* HBitmapToIplImage(HBITMAP hBmp) 



{ 



BITMAP bmp; 



::GetObject(hBmp,sizeof(BITMAP),&bmp); 

int nChannels = bmp.bmBitsPixel == 1 ? 1 : 

bmp.bmBitsPixel/8 ; 
int depth = bmp.bmBitsPixel == 1 ? IPL_DEPTH_1U 
: IPL_DEPTH_8U; 

Ipllmage* img = cvCreateImageHeader( 

cvSize(bmp.bmWidth, bmp.bmHeight) 
, depth, nChannels ); 

img->imageData =(char*)malloc( 

bmp.bmHeight*bmp.bmWidth*nChan 
nels*sizeof(char)); 
memcpy(img->imageData,(char*)( 

bmp.bmBits),bmp.bmHeight*b 
mp.bmWidth*nChannels); 



Per esportare le funzioni in modo da condivi- 
derle con un'applicazione di gestione, dob- 
biamo definire l'intestazione di ciascuna fun- 
zione nel modo seguente 

extern "C" declspec(dllexport) bool stdcall 

InitCamera(){...} 

Le keyword extern "C" declspec(dllexport) 

sono necessarie per indicare al compilatore 
che la funzione InitCameraO deve essere 
esportata e quindi deve essere resa visibile 
all'esterno e il nome della funzione deve 
essere creato utilizzando il linking di tipo "C" 
(export "C"). 

Si poteva usare anche il linking normale di 
tipo C++ ma il compilatore avrebbe creato per 
la funzione, a causa della name decoration 
diversa, un nome strano e avremmo dovuto 
seguire altri step per modificarlo in base alle 
nostre esigenze. 
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APPLICAZIONE 

Tramite la CamLibrary qualsiasi applicazione 
può prendere il controllo della webcam, ini- 
zializzarla, calibrarla in modo da determinare 
il modello del target e individuare il punto del 
laser in coordinate relative al centro del mo- 
dello. Ad esempio, da un'applicazione .Net 
possiamo interfacciarci con la CamLibrary 
nel modo seguente. Per prima cosa bisogna 
inserire fra la lista dei namespace referenziati 
bisogna la seguente riga: 

using System. Runtime.InteropServices; 

Poi copiamo la DLL creata precedentemente 
nella stessa cartella dell'eseguibile in modo 
che la possa vedere; infine, dopo la definizio- 
ne della classe introduciamo le varie chiama- 
te ai metodi esportati dalla CamLibrary 

[DIIImport("Caml_ibrary.dH")] 

public static extern bool InitCamera(); 

utilizziamo Dlllmport per indicare al compi- 
latore che stiamo importando una funzione 
dalla libreria CamLibrary.dll, di seguito tro- 
viamo il prototipo della funziona esportata. A 
questo punto abbiamo proprio tutto: la libre- 
ria di interfaccia e gli strumenti per utilizzar- 
la. Per realizzare il gioco basta ricordarsi di: 

• inizializzare la webcam 

• effettuare delle istantanee 

• calibrare il dispositivo fino a trovare un mo- 
dello ricostruito abbastanza soddisfacente del 
target, chiamando ripetutamente Find_Circles 
(dopo aver recuperato l'istantanea) 

• una volta calibrata la videocamera digitale si 
procede con l'individuazione del dot richia- 
mando il metodo Find_Shot dopo aver impo- 
stato un adeguato lasso di tempo, 



TECNICA 

La costruzione della CamLibrary ci ha sem- 
plificato di molto lo sviluppo dell'applicazio- 
ne in sé. Infatti, il tutto si riduce ad istanziare 
un timer che ad intervalli di tempo prefissati 
esegue nel suo gestore del tick una serie di 
controlli sull'istantanea prodotta. Ad esem- 
pio, il modulo di calibrazione è subito realiz- 
zato nel modo seguente: 



if (GrabFrame()){ 



System. IntPtr intPtr=RetrieveFrame(); 
Bitmap bitmap=Bitmap.FromHbitmap(intPtr); 



video. Immagine=bitmap; 



if (trovatoC=Find_Circles()){ 



centro[0]=Centro_X(); 



centro[l]=Centro_Y(); 



raggio=Centro_R(); 



video. Centro=new Point(centro[0],centro[l]); 



video. Raggio= raggio; 



game.Raggio=raggio; 



game.Centro=new Point(centro[0],centro[l]); 



btnGioca.ImageIndex=3; 



toolTipl.SetToolTip(btnGioca, "Nuova partita");} 



} 



timerCalibra.Enabled=true; 



> 



Si comincia "scattando" l'istantanea richia- 
mando GrabFrameO e recuperando la bitmap 
in memoria per poterla visualizzare, dopo di 
che si richiama il metodo Find_Circles() su 
questa immagine in memoria e se la procedu- 
ra va a buon fine si recuperano le coordinare 
X e Y del centro e il raggio del cerchio base. 
Il modulo per l'individuazione del punto del 
laser è molto simile 

private void timerGioca_Tick(object sender, EventArgs e) 
{ 
bool trovatoS=false; 
timerGioca.Enabled=false; 
if (GrabFrameO) 
{ 

System. IntPtr intPtr=RetrieveFrame(); 
Bitmap bitmap= Bitmap. FromHbitmap(intPtr); 
video. Immagine=bitmap; 
Find_Shot(); 
if((new TimeSpan(DateTime.Now.Ticks- 

lastShot)).Milliseconds>700) 

{trovatoS=Shot_X()!=Q && Shot_Y()! = Q; 

game.Abilita(); 
if(trovatoS) 

{ 

shot[0] = Shot_X(); 

shot[l]=Shot_Y(); 

lastShot=DateTime.Now.Ticks; 

game.Shot=new Point(Shot_X(),Shot_Y()); 



_J 

timerGioca.Enabled=true; 
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private void timerCalibra_Tick(object sender, 

EventArgs e) 
{bool trovatoC=false; 
timerCalibra.Enabled=false; 



Le coordinare sono in sistema relativo al cen- 
tro del modello ricostruito, quindi tengono 
conto di quanto "distano" dal centro stesso. 
Ing. Antonino Panella 
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APPLICAZIONE 

Tramite la CamLibrary qualsiasi applicazione 
può prendere il controllo della webcam, ini- 
zializzarla, calibrarla in modo da determinare 
il modello del target e individuare il punto del 
laser in coordinate relative al centro del mo- 
dello. Ad esempio, da un'applicazione .Net 
possiamo interfacciarci con la CamLibrary 
nel modo seguente. Per prima cosa bisogna 
inserire fra la lista dei namespace referenziati 
bisogna la seguente riga: 

using System. Runtime.InteropServices; 

Poi copiamo la DLL creata precedentemente 
nella stessa cartella dell'eseguibile in modo 
che la possa vedere; infine, dopo la definizio- 
ne della classe introduciamo le varie chiama- 
te ai metodi esportati dalla CamLibrary 

[DIIImport("Caml_ibrary.dH")] 

public static extern bool InitCamera(); 

utilizziamo Dlllmport per indicare al compi- 
latore che stiamo importando una funzione 
dalla libreria CamLibrary.dll, di seguito tro- 
viamo il prototipo della funziona esportata. A 
questo punto abbiamo proprio tutto: la libre- 
ria di interfaccia e gli strumenti per utilizzar- 
la. Per realizzare il gioco basta ricordarsi di: 

• inizializzare la webcam 

• effettuare delle istantanee 

• calibrare il dispositivo fino a trovare un mo- 
dello ricostruito abbastanza soddisfacente del 
target, chiamando ripetutamente Find_Circles 
(dopo aver recuperato l'istantanea) 

• una volta calibrata la videocamera digitale si 
procede con l'individuazione del dot richia- 
mando il metodo Find_Shot dopo aver impo- 
stato un adeguato lasso di tempo, 



TECNICA 

La costruzione della CamLibrary ci ha sem- 
plificato di molto lo sviluppo dell'applicazio- 
ne in sé. Infatti, il tutto si riduce ad istanziare 
un timer che ad intervalli di tempo prefissati 
esegue nel suo gestore del tick una serie di 
controlli sull'istantanea prodotta. Ad esem- 
pio, il modulo di calibrazione è subito realiz- 
zato nel modo seguente: 



if (GrabFrameQK 



System. IntPtr intPtr=RetrieveFrame(); 
Bitmap bitmap=Bitmap.FromHbitmap(intPtr); 



video. Immagine=bitmap; 



if (trovatoC=Find_Circles()){ 



centro[0]=Centro_X(); 



centro[l]=Centro_Y(); 



raggio=Centro_R(); 



video. Centro=new Point(centro[0],centro[l]); 



video. Raggio= raggio; 



game. Raggio= raggio; 



game.Centro=new Point(centro[0],centro[l]); 



btnGioca.ImageIndex=3; 



toolTipl.SetToolTip(btnGioca, "Nuova partita");} 



} 



timerCalibra.Enabled=true; 



> 



Si comincia "scattando" l'istantanea richia- 
mando GrabFrameO e recuperando la bitmap 
in memoria per poterla visualizzare, dopo di 
che si richiama il metodo Find_Circles() su 
questa immagine in memoria e se la procedu- 
ra va a buon fine si recuperano le coordinare 
X e Y del centro e il raggio del cerchio base. 
Il modulo per l'individuazione del punto del 
laser è molto simile 

private void timerGioca_Tick(object sender, EventArgs e) 
{ 
bool trovatoS=false; 
timerGioca.Enabled=false; 
if (GrabFrameO) 
{ 

System. IntPtr intPtr=RetrieveFrame(); 
Bitmap bitmap= Bitmap. FromHbitmap(intPtr); 
video. Immagine= bitmap; 

Find_Shot(); 

if((new TimeSpan(DateTime.Now.Ticks- 

lastShot)).Milliseconds>700) 

{trovatoS=Shot_X()! = && Shot_Y()! = 0; 

game.Abilita(); 
if(trovatoS) 

{ 

shot[0]=Shot_X(); 

shot[l]=Shot_Y(); 

lastShot=DateTime.Now.Ticks; 

game.Shot=new Point(Shot_X(),Shot_Y()); 
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private void timerCalibra_Tick(object sender, 

EventArgs e) 
{bool trovatoC=false; 
timerCalibra.Enabled=false; 



Le coordinare sono in sistema relativo al cen- 
tro del modello ricostruito, quindi tengono 
conto di quanto "distano" dal centro stesso. 

Antonino Panella 



http://www.ioprogrammo.it 



Aprile 2006/ 21 ► 



COVER STORY T ■ Visual Basic e il multimedia 



VISUALIZZARE IMMAGINI 
DA UNA WEBCAM 

LE AVICAP WINDOW CLASS, MESSE A DISPOSIZIONE DAL SISTEMA OPERATIVO WINDOWS 
PERMETTONO DI GESTIRE, FACILMENTE, I PROCESSI DI ACQUISIZIONE PROVENIENTI DA 
QUALSIASI DISPOSITIVO VIDEO 
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Webcam.zip 
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Conoscenze richieste 



NET Framework, 



u 



I 



Sviluppo Windows 



Sistema 

operativo:Windows 
2000/XP. Visual Basic 
.NET 2003. 



Eoa 



Tempo di realizzazione 



A: 



ttualmente le webcam sono periferi- 
che di uso molto comune per Tutiliz- 
. zo in chat o in videoconferenza, an- 
che per il costo ridotto alla portata di tutti. In 
questo articolo vedremo come acquisire im- 
magini tramite una webcam in una applica- 
zione .Net per mezzo delle classi AVICap. 
La libreria AVIcap wìndow class (avicap32.dll) 
raggruppa, e permette di gestire, le funziona- 
lità multimediali che l'ambiente Windows 
mette a disposizione per interfacciarsi con 
qualsiasi dispositivo audio-visivo, senza do- 
verci preoccupare dei dispositivi stessi 
La potenzialità maggiore della libreria è l'in- 
teroperabilità con qualunque tipo di disposi- 
tivo di acquisizione installato nel sistema. 



IL NAMESPACE 
SYSTEM. RUNTIME 
.IIMTEROPSERVICES 

Per accedere al flusso di dati inviati dalla no- 
stra webcam dovremo utilizzare due DLL di 
sistema, YAvicap32.dll e la User32.dll, e per 
farlo è necessario creare delle funzioni che fa- 
ranno da puntatori alle funzioni interne delle 
nostre dll. 

Il namespace Sy sterri. Runtìme. Inter opServices 
mette a disposizione metodi ed attributi che 
ci permetteranno di lavorare con COM e ser- 
vizi di chiamata al sistema operativo. 
In particolare, in Visual Basic la conversione 
degli argomenti in tipi di dati compatibili, un 
processo definito marshallìng, viene eseguita 
automaticamente. Per controllare in modo 
esplicito il marshallìng degli argomenti è 
possibile utilizzare l'attributo MarshalAs. 
In tutti gli esempi di codice, per evitare di 
scrivere ogni volta il nome completo della li- 
breria, diamo per scontato l'inserimento del- 
la seguente istruzione Imports: 

Imports System 



Imports System. Runtime.InteropServices 

f Per iniziare, creiamo un nuovo progetto 
Windows Applications e sulla finestra 
Formi disegniamo l'interfaccia utente, in 
particolare piazziamo un po' di controlli con- 
tenitore GroupBox per ingentilire la finestra e 
per raggruppare i controlli. 
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WebCam - 
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Selezioniamo un controllo PictureBox 
dalla casella degli strumenti, e disegnia- 
molo sulla form. Dalla finestra delle proprietà 
cambiamo il nome in PictureBoxWebCam. In 
PictureBoxWebCam visualizzeremo le imma- 
gini provenienti dalla webcam. 
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Selezioniamo un controllo ListBox dalla 
casella degli strumenti, e disegniamolo 
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sulla form. Dalla finestra delle proprietà cam- 
biamo il nome in ListBoxDispo. In ListBoxDi- 
spo visualizzeremo i nomi dei dispositivi di 
acquisizione video presenti nel sistema. 



^y| ihi< 







4 Selezioniamo un controllo TextBox dalla 
casella degli strumenti, e disegniamolo 
sulla form. Dalla finestra delle proprietà cam- 
biamo il nome in TextBoxNomeFile. In Text- 
BoxNomeFile visualizzeremo il nome del file 
in cui verrà memorizzata l'immagine cattura- 
ta dalla webcam. 
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Selezioniamo quattro controlli Command- 
Button dalla casella degli strumenti, e 
disegniamoli sulla form. Dalla finestra delle 
proprietà cambiamo i nomi in ButtonAvvia, 
ButtonArresta, ButtonCattura, ButtonScegli. 
ButtonScegli ci permetterà di scegliere il no- 
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me del file da una finestra di dialogo, gli altri 
CommandButton ci permetteranno di gestire 
la webcam. 

Selezioniamo quattro controlli RadioBut- 
ton dalla casella degli strumenti, e dise- 
gniamoli sulla form. Dalla finestra delle pro- 
prietà cambiamo il nome in RadioButtonJpeg, 
RadioButtonGif, RadioButtonPng, RadioBut- 
tonBmp. Selezionando uno dei quattro Ra- 
dioButton, si può scegliere il formato dell'im- 
magine catturata dalla webcam 
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ELENCO DEI DISPOSITIVI 
INSTALLATI 

Prima di compiere qualsiasi operazione con 
immagini provenienti da una webcam, dob- 
biamo, ovviamente, assicurarci di avere una 
webcam e che sia correttamente installata. 
Per questo motivo, dovremo controllare l'esi- 
stenza di almeno un dispositivo di acquisizio- 
ne video. 

Nel nostro progetto aggiungiamo un modulo 
Definizioni, nel quale inseriremo: le dichiara- 
zioni delle API, le dichiarazioni delle costanti 
da utilizzare con AVICap window class e le di- 
chiarazioni delle routine di interfacciamento 
con il dispositivo di acquisizione. 



PRIMA DI VB.NET? 



Nelle versioni precedenti di 
Visual Basic era possibile 
dichiarare parametri As Any, che 
indicavano la possibilità di 
utilizzare qualsiasi tipo di dati. In 
Visual Basic .NET è necessario 
utilizzare un tipo di dati specifico 
in tutte le istruzioni di 
dichiarazione. Nel nostro caso 
possiamo utilizzare l'attributo 
MarshalAs con il compito di 
indicare che il tipo di dati 





UO! APPUNTI 



sottostante il parametro IParam 
deve essere sottoposta a 
marshalling come struttura di 
tipo. Per il parametro IParam 
della SendMessage utilizziamo il 
membro AsAny dell'enumerazio- 
ne UnmanagedType. AsAny 
rappresenta un tipo dinamico che 
determina il tipo di un oggetto in 
fase di esecuzione ed effettua il 
marshalling dell'oggetto come 
suddetto tipo. 
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È possibile utilizzare la 

parola chiave Alias per 

indicare che il nome 

della routine da 

chiamare è diverso 

nella DLL. 



Nel modulo Definizioni definiamo la funzio- 
ne capGetDriverDescription che fa riferimen- 
to a una funzione esistente in avicap32.dll. 
Questa funzione restituisce True se esiste un 
dispositivo di acquisizione, o False nel caso 
contrario 

Public Declare Function capGetDriverDescription Lib 

"avicap32.dll" Alias "capGetDriverDescriptionA" 

(ByVal wDriverlndex As Short, ByVal IpszName As 

String, ByVal cbName As Integer, ByVal IpszVer As 

String, ByVal cover As Integer) As Boolean 

I parametri che si devono passare alla funzio- 
ne, con valore non nullo, sono: 

• wDriverlndex. Indice del dispositivo di 
acquisizione. Può variare da a 9. 

• IpszName. Punta al buffer che contiene il 
nome del dispositivo di acquisizione. 

• cbName. Indica la lunghezza, in bytes, del 
buffer puntato da IpszName. 

• IpszVer. Punta al buffer che contiene la 
versione del dispositivo di acquisizione. 

• cbVer. Indica la lunghezza, in byte, del buf- 
fer puntato da IpszVer. 

La lista dei dispositivi disponibili, dovrà esse- 
re visualizzata all'apertura dell' applicazione, 
per questo scriviamo il codice necessario nel- 
l'evento Load di Formi 

Private Sub Forml_Load( ByVal sender As System. Object, 
ByVal e As System. EventArgs) Handles My Base. Load 



Do 



Dispositivo = capGetDriverDescription( 

i, NomeDispositivo, 100, Versione, 100) 

If Dispositivo Then ListBoxDispo.Items.Add( 

NomeDispositivo) 

i += 1 

Loop Until Dispositivo = False 

Per effetto di queste istruzioni possiamo ve- 
dere elencati i dispositivi installati nel siste- 
ma, nel caso del sistema di test è presente una 
WebCam Creative come si può vedere in figu- 
ra, ma il risultato si ottiene per qualsiasi altra 
webcam. 




Fig. 1: La lista dei dispositivi installati nel sistema 

A questo punto l'utente potrà selezionare il 
dispositivo di acquisizione da utilizzare, sem- 
plicemente cliccando con il mouse nella lista. 
Il codice necessario dovrà essere scritto, 
quindi, nell'evento SelectedlndexChanged 
della ListBox. 



End Sub 

Definiamo due variabili (NomeDispositivo, 
Versione) in cui memorizzare il nome e la ver- 
sione del dispositivo di acquisizione. È neces- 
sario inizializzare queste variabili perché in 
caso contrario anche dopo il loro utilizzo, ri- 
sulteranno sempre nuli. 

Definiamo inoltre una variabile di controllo 
ed una variabile indice 

Dim NomeDispositivo As String = Space(lOO) 
Dim Versione As String = Space(lOO) 
Dim Dispositivo As Boolean 
Dim i As Integer 

Scriviamo un ciclo in cui elenchiamo tutti i 
dispositivi disponibili e li aggiungiamo in 
ListBoxDispo 



Private Sub ListBoxDispo_SelectedIndexChanged( 

ByVal sender As System. Object, ByVal e As 
System. EventArgs) Handles 
ListBoxDispo. SelectedlndexChanged 
idDispositivo = ListBoxDispo. Selectedlndex 
End Sub 

Dove idDispositivo è una variabile definita in 
formi in cui memorizzare il numero identifi- 
cativo del dispositivo di acquisizione selezio- 
nato 

Dim idDispositivo As Integer 



MODULO DEFINIZIONI 

Ora che abbiamo selezionato il nostro dispo- 
sitivo di acquisizione, siamo pronti per realiz- 
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zare un piccolo riquadro di preview, che ci 
farà vedere in tempo reale le immagini che la 
nostra webcam invia al sistema. Per far ciò 
dobbiamo utilizzare, ancora, delle funzioni 
messe a disposizione dalle DLL avicap32 e 
user32, per questo motivo sempre nel modu- 
lo Definizioni scriviamo: 

Public Declare Function capCreateCaptureWindow Lib 

"avicap32.dll" Alias "capCreateCaptureWindowA" 

(ByVal IpszWindowName As String, ByVal dwStyle As 

Integer, ByVal x As Integer, ByVal y As Integer, 

ByVal 

nWidth As Integer, ByVal nHeight As Short, ByVal 

hWnd As Integer, ByVal nID As Integer) As Integer 



hWndlnsertAfter As Integer, ByVal x As Integer, 

ByVal y As Integer, ByVal ex As Integer, ByVal cy As 

Integer, ByVal wFlags As Integer) As Integer 



IL RIQUADRO 
DI ANTEPRIMA 

Torniamo nella finestra del codice di formi e 
definiamo la variabile in cui memorizzare 
Thandle da utilizzare nella finestra di acquisi- 
zione, per la connessione con il driver di cat- 
tura 

Dim hHwnd As Integer 




La funzione capCreateCaptureWindow per- 
mette l'utilizzo di una superficie per la visua- 
lizzazione e la cattura di un segnale video 
esterno. I parametri che si devono passare al- 
la funzione, con valore non nullo, sono: 

• IpszWindowName. Indica il nome della su- 
perficie di acquisizione 

• dwstyle. Indica lo stile della superficie di 
acquisizione 

• X, Y, nWidth, nHeight. Indicano il posizio- 
namento e le dimensioni della superficie 
di acquisizione 

• hWnd. Indica Thandle del controllo conte- 
nitore della superficie di acquisizione. 

La funzione capCreateCaptureWindow resti- 
tuisce un valore di tipo Long, che rappresen- 
ta il valore di handle da utilizzare nella fine- 
stra di acquisizione per la connessione con il 
driver di cattura. 

La connessione al driver di acquisizione vie- 
ne effettuata tramite la funzione SendMessa- 
ge di user32.dll che permette di inviare mes- 
saggi alla avicap32, dopo aver impostato il 
flusso di dati 

Public Declare Function SendMessage Lib "user32" 

Alias "SendMessageA" (ByVal hwnd As Integer, ByVal 

wMsg As Integer, ByVal wParam As Integer, 

<MarshalAs(UnmanagedType.AsAny)> ByVal IParam 

As Object) As Integer 



Il codice necessario a visualizzare le immagi- 
ni provenienti dalla webcam, dovrà essere 
scritto nell'evento click di ButtonAvvia: 

Private Sub ButtonAvvia_Click(ByVal sender As 

System. Object, ByVal e As System. EventArgs) 
Handles ButtonAvvia. Click 

End Sub 

All'interno di ButtonAvvia _Click definiamo 
due variabili in cui memorizzare l'altezza e la 
larghezza del PictureBox (PictureBoxWeb- 
Cam) in cui visualizzeremo le immagini 

Dim iHeight As Integer = 

PictureBoxWebCam.Height 
Dim iWidth As Integer = 

PictureBoxWebCam.Width 

Utilizziamo la funzione capCreateCapture- 
Window per indicare al sistema che il flusso 
di dati dovrà essere inviato al nostro Picture- 
Box, passando come parametro il valore Pie- 
tur eBoxWebCam. Handle. ToInt32 che identifi- 
ca univocamente il controllo. 
Oltre a questo parametro passiamo: la 
dimensione del frame di cattura (640, 480), e 
le costanti WS_VISIBLE e WS_CHILD (vedi 
box) 

hHwnd = capCreateCaptureWindow( 

"Anteprima", WS_VISIBLE Or WS_CHILD, 

0, 0, 640, _480, 

PictureBoxWebCam.Handle.ToInt32, 0) 



& 



LOSSARIO 



GRABBIMG 

Il termine grabbing 
identifica il 
procedimento di 
cattura di un singolo 
fotogramma dal flusso 
video riprodotto in una 
superficie di 
acquisizione. 



STREAMING 

Il termine streaming 
identifica, il 
procedimento di 
registrazione di una 
sequenza {stream) dal 
flusso video riprodotto 
in una superficie di 
acquisizione. 



Infine dobbiamo definire la funzione SetWin- 
dowPos che verrà utilizzata per ridimensio- 
nare la finestra del flusso di dati. 

Public Declare Function SetWindowPos Lib "user32" 
Alias "SetWindowPos" (ByVal hwnd As Integer, ByVal 



A questo punto dobbiamo collegarci alla 
webcam richiamando la funzione SendMes- 
sage, passando come parametri: Thandle del 
PictureBox, la costante WM_CAP_DRIVER_ 
CONNECT e l'identificativo del dispositivo 
selezionato. 
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La classe Bìtmap 

incapsula una bitmap 

GDI+ costituita dai 

pixel di un'immagine e 

dai relativi attributi. 

Bitmap è un oggetto 

utilizzato per operare 

con le immagini 

definite dai dati pixel. 

Il metodo Save della 

classe Bitmap salva 

l'immagine nel file e 

nel formato specificati. 



If SendMessage(hHwnd, 

WM_CAP_DRIVER_CONNECT, 
idDispositivo, 0) Then 

È necessario il test sul valore restituito dalla 
funzione poiché si può verificare un fallimen- 
to (risultatolo) in uno dei tre casi seguenti: 

• Nel sistema non sono installati dispositivi 
di acquisizione. 

• il dispositivo è installato, ma non corretta- 
mente. 

• il dispositivo è installato correttamente 
ma è già attivo un altro applicativo con- 
nesso con il driver. Ad ogni driver infatti 
può essere connessa una sola superficie di 
visualizzazione, e di cattura, alla volta. 

Ora che siamo connessi con la nostra web- 
cam, dobbiamo impostare le dimensioni del 
flusso di immagini in base alle dimensioni 
del nostro controllo di anteprima, impostare 
i frame di acquisizione e far partire il proces- 
so di acquisizione: 

'Impostiamo la scala dell'anteprima 
SendMessage(hHwnd, WM_CAP_SET_SCALE, 

True, 0) 

'Impostiamo il rate in millisecondi 
SendMessage(hHwnd, 
WM_CAP_SET_PREVIEWRATE, 66, 0) 

'Facciamo partire l'anteprima 
SendMessage(hHwnd, 
WM_CAP_SET_PREVIEW, True, 0) 

'Scaliamo le immagini alle dimensioni del 

nostro PictureBox 
SetWindowPos(hHwnd, HWND_BOTTOM, 0, 
0, iWidth, iHeight, _SWP_NOMOVE Or 
SWP_NOZORDER) 

Infine nel ramo Else, in cui si entra nel caso di 
dispositivo non presente, chiudiamo la 
superficie di acquisizione utilizzando la fun- 
zione DestroyWìndow, presente nella user- 
32dll. DestroyWìndow dovrà essere definita 
sempre nel modulo definizioni con la se- 
guente sintassi: 

Public Declare Function DestroyWìndow Lib "user32" 
(ByVal hndw As Integer) As Boolean 

La funzione DestroyWìndow aspetta come 
unico parametro l'handle della nostra super- 



ficie di acquisizione, per questo possiamo 
scrivere: 

Else 

DestroyWindow(hHwnd) 
End If 

Come risultato del codice appena scritto, nel 
momento in cui premiamo il pulsante But- 
tonAvvia vedremo comparire all'interno del 
pictureBox, in tempo reale, le immagini pro- 
venienti dalla nostra Webcam. 




Fig. 2: Le immagini provenienti dalla webcam 



PULSANTE DI ARRESTO 

Per terminare le operazioni di acquisizione, 
l'utente dovrà premere il pulsante ButtonAr- 
resta, per questo dobbiamo scrivere il codice 
necessario nell'evento Click. 

Private Sub ButtonArresta_Click(ByVal sender As 

System. Object, ByVal e As System. EventArgs) 
Handles ButtonArresta. Click 

End Sub 

Le operazioni da compiere saranno: discon- 
nettere la periferica, chiudere la superficie di 
acquisizione. Per questo utilizziamo sempre 
la funzione SendMessage, passando come pa- 
rametri: l'handle del PictureBox, la costante 
WM_CAP_DRIVER_DISCONNECT e l'identifi- 
cativo del dispositivo selezionato. Infine uti- 
lizziamo la funzione DestroyWìndow vista in 
precedenza 

SendMessage(hHwnd, 

WM_CAP_DRIVER_DISCONNECT, 
idDispositivo, 0) 
DestroyWindow(hHwnd) 
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SALVARE L'IMMAGINE 
IN UN FILE 

Dopo aver attivato la nostra WebCam possia- 
mo catturare un singolo frame e salvarlo in un 
file immagine. La prima operazione da com- 
piere è quella di scegliere il nome del file in 
cui conservare l'immagine, per questo scrivia- 
mo il codice necessario nell'evento Click del 
pulsante ButtonSelez 

Private Sub ButtonSelez_Click(ByVal sender As 

System.Object, ByVal e As System. EventArgs) 
Handles ButtonSelez. Click 
SaveFileDialogl.ShowDialogO 
TextBoxNomeFile.Text = SaveFileDialogl.FileName 
End Sub 



versione e cancellare il file temporaneo 

If RadioButtonBmp.Checked = False Then 
ConvertiDaBMP(NomeFile) 
System. IO. File. Delete(NomeFile) 

End If 

La procedura ConvertiDaBMP riceve il nome 
del file temporaneo da convertire, e genera un 
nuovo file nel formato selezionato. Per otte- 
nere il risultato voluto, utilizziamo la classe 
Bitmap che abbiamo ampiamente descritto in 
un precedente articolo sul GDI+ (per utilizza- 
re la classe Bitmap dobbiamo scrivere una 
istruzione Import in cima al codice di Formi: 
Imports System. Drawing.Imaging) 




Molto semplicemente abbiamo mostrato la fi- 
nestra di dialogo "Salva" in cui abbiamo sele- 
zionato il path ed il nome del file, ed abbiamo 
mostrato la scelta in TextBoxNomeFile. 
Una volta scelto il nome del file, possiamo 
cliccare sul pulsante "Cattura" per avviare il 
processo di salvataggio del frame catturato. 
Scriviamo il codice necessario nell'evento 
Click di ButtonCattura 

Private Sub ButtonCattura_Click(ByVal sender As 

System.Object, ByVal e As System. EventArgs) 
Handles ButtonCattura. Click 
End Sub 

Dichiariamo una variabile NomeFile che do- 
vrà contenere il nome del file selezionato. La 
libreria avicap32.dll salva esclusivamente in 
formato bmp, per questo se l'utente seleziona 
un formato diverso, dovremo salvare il risulta- 
to in un file temporaneo che sarà oggetto di 
una successiva decodifica. 

Dim NomeFile As String 

If RadioButtonBmp.Checked Then 

NomeFile = TextBoxNomeFile.Text & ".bmp" 
Else 

NomeFile = TextBoxNomeFile.Text & 

"temp.bmp" 
End If 

Per salvare il frame in un file, è sufficiente ese- 
guire una chiamata alla funzione SendMessa- 
ge passando come parametro la costante per il 
salvataggio ed il percorso del file 

SendMessage(hHwnd, WM_CAP_FILE_SAVEDIB, 

0&, NomeFile) 

Se l'utente ha selezionato un formato diverso 
dal formato Bmp, dobbiamo avviare la con- 



Private Sub Converti Da BMP( ByVal NomeFile As String) 
Try 

Dim objBmp As New Bitmap(NomeFile) 
If RadioButtonJpeg.Checked Then 

objBmp.Save(TextBoxNomeFile.Text & 

".jpg", ImageFormat.Jpeg) 

End If 

If RadioButtonGif.Checked Then 

objBmp.Save(TextBoxNomeFile.Text & 

".gif", ImageFormat.Gif) 

End If 

If RadioButtonPng.Checked Then 

objBmp.Save(TextBoxNomeFile.Text & 

".Png", ImageFormat.Png) 

End If 

objBmp.Dispose() 
Catch 
End Try 
End Sub 



Luigi Buono 



L'ELENCO DI COSTANTI NECESSARIE 
PER DIALOGARE CON LA DLL AVICAP 



Public Const WM_CAP As Short = 
&H4QQS 

Public Const WMJJSER As Long = 
&H400 

Public Const 

WM_CAP_DRIVER_CONNECT As 

Integer = WM_CAP + 10 

Public Const 

WM_CAP_DRIVER_DISCONNECT 

As Integer = WM_CAP +11 

Public Const WM_CAP_EDIT_COPY 

As Integer = WM_CAP + 30 

Public Const 

WM_CAP_FILE_SAVEDIB As Long 

= WMJJSER + 25 

Public Const WM_CAP_FILE_SAVEAS 

As Long = WMJJSER + 23 

Public Const 



WM_CAP_SET_PREVIEW As 
Integer = WM_CAP + 50 



Public Const 

WM_CAP_SET_PREVIEWRATE As 
Integer = WM_CAP + 52 



Public Const WM_CAP_SET_SCALE 
As Integer = WM_CAP + 53 



Public Const WS_CHILD As Integer 
= &H40000000 



Public Const WS_VISIBLE As 
Integer = &H10000000 



Public Const SWPJMOMOVE As 

Short = &H2S 



Public Const SWP_NOSIZE As Short 



Public Const SWPJMOZORDER As 

Short = &H4S 



Public Const HWND_ 



BOTTO M As 

Short = 1 
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Come utilizzare Animadead e l'SDL 



SKELETALANIMATION 

ANIMADEAD È UNA LIBRERIA PROGETTATA E REALIZZATA PER CONSENTIRE A 
QUALUNQUE APPLICAZIONE DI ESEGUIRE ANIMAZIONI DI FIGURE TRIDIMENSIONALI 
CON UNA TECNICA CHE LE RENDE PARTICOLARMENTE REALISTICHE. VEDIAMO QUALE 




REQUISITI 



■ Min niii'ii'i ^m 

— Grafica Tridimensionale 
1 e Linguaggio C++ 



t Visual Studio .Net 2003 
o Dev-C++ 




Molti di voi saranno sicuramente rimasti 
affascinati dagli effetti visivi di giochi 
come Unreal Tournament 2004 della 
Epic Games o come Splinter Celi della Ubi Soft. 
In questi giochi i vari personaggi che si aggirano 
sullo schermo si muovono, camminano e com- 
battono in un modo molto realistico. Certamente 
tanto è dovuto alla capacità di calcolo delle con- 
sole e dei PC di ultima generazione, ma questo 
realismo non si sarebbe mai potuto ottenere, 
neppure con il più sofisticato sistema di intelli- 
genza artificiale, se il mondo della programma- 
zione "ludica" non avesse tratto ispirazione dal- 
l'anatomia. Infatti, il nostro corpo si muove gra- 
zie a quello che lo sostiene e gli dona rigidità e 
cioè lo scheletro. Il principio di base è lo stesso: i 
personaggi di questi giochi sono stati "costruiti" 
in grafica dotandoli di uno scheletro (spesso 
chiamato sostegno o armatura interna della figu- 
ra) e legando il corpo esterno a questo scheletro. 
In questo modo si ottiene un pupazzo virtuale 
che si può muovere e sistemare come si farebbe 
con una bambola vera. Ciò è molto utile nei casi 
in cui il movimento del modello deve essere 
comandato dall'utente, come appunto in molti 
giochi per computer e console, ma che può tro- 
vare riscontro anche in altri settori. 
Tramite una telecamera è possibile, ad esempio, 
studiare il movimento di una persona ed utiliz- 
zando oppurtuni marcatori visivi si costruisce un 
modello tridimensionale del suo scheletro. In 
questo modo, si ottiene una figura che può assu- 
mere diverse pose (preimpostate) e l'effetto del 
movimento lo si crea attraverso l'assegnazione di 
una delle pose in un certo intervallo di tempo. 




Bloodshed Dev-C++ è un 
ambiente di sviluppo integrato 
scritto in Delphi completamente 
gratuito (Open Source), con 
tutte le funzionalità richieste, 
per la programmazione in C e 
C++ dove il compilatore usato è 
Mingw che fa parte della GNU 



Compiler Collection. Gira su 
sistemi Win32, a partire da 
Windows 95 a XP, sia come 
console o con interfaccia grafica. 
Dev-C++ può anche essere usato 
congiuntamente a Cygwin o a 
qualunque altro compilatore 
basato GCC. 



COSTRUIRE IL MODELLO 

La prima cosa da fare quindi è avere ben in mente 
la figura finale di cui si vuole ottenere il modello 
3D, disegnarlo con un buon programma di gra- 
fica, come 3D Studio Max e Maya, per poi "in- 
trodurvi" lo scheletro. Consideriamo il seguente 
esempio. Prendiamo una figura semplice che ri- 
corda un uomo stilizzato, senza mani e piedi, una 
forma tipica degli omini di pan di zenzero tanto 
diffusi nella cultura anglossassone. 



AGGIUNGERE 
LO SCHELETRO 

Il passo successivo sarà quello di dargli uno armatu- 
ra (lo scheletro): lo scopo dell'armatura sarà quello 
di vincolare i movimenti in modo da irrigidire la 
struttura ed impedire di assumere pose innaturali 
(ad esempio un ginocchio che si piega all'indietro). 
La semplicità del personaggio è tale da non richie- 
dere un'armatura troppo complessa, basteranno 
quattro arti (due braccia e due gambe) ed un paio di 
giunture per gli arti inferiori, solo le ginocchia e non 
i gomiti. La presenza di collo, mani e piedi avrebbe 
complicato la struttura, sempre però relizzabile con 
un pò di pazienza. A questo punto abbiamo già il 
modello, ma ancora corpo e scheletro sono slegati: 
bisogna infatti far aderire il rivestimento all'armatu- 
ra e vincolarli in modo che che una deformazione 
dello scheletro provochi una deformazione del 
corpo. Ciò è ottenibile assegnando i vertici alle ossa 
in modo che ogni porzione di corpo abbia un suo 
osso e che ciascun osso sia legato ad un altro in 
modo da vincolare movimenti della figura. 



Il\l POSA! 

Adesso il personaggio è veramente finito! All'interno 
del programma di grafica possiamo giocare con 
questo modello come se fosse una bambola, pronta 
ad assumere tutte le pose che ci vengono in mente, 
sempre tenendo presente il vincolo dello scheletro. 
Si può costruire una posa impostando la posizione e 
la rotazione di ciascun osso: dato che esiste un lega- 
me con il rivestimento, in base allo scheletro il pro- 
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gramma di rendering aggiornerà l'esterno in modo 
adattarlo alla posa scelta. L'animazione sarà quindi 
composta da singole pose. Utilizzando la stessa ar- 
matura è possibile costruire diverse animazioni in 
modo da soddisfare tutte le esigenze "sceniche" che 
si dovessere incontrare: ad esempio, si potrebbe in- 
dividuare anche un movimento delle braccia o di 
rotazione del busto oltre naturalemente alla possibi- 
lità di far camminare il personaggio. 



SKELETAL ANIMATION 

Da una parte abbiamo quindi le meshes, tutte le 
forme geometriche e il legame delle strutture che 
costituiscono il look complessivo (lo scheletro della 
figura, e naturalmente il legame con il rivestimento), 
mentre dall'altra ci sono le animations cioè tutti i 
possibili movimenti previsti (l'insieme delle pose 
per l'oggetto ad ogni intervallo di tempo). Mantene- 
re separate le meshes dalle animations può tornare 
molto ultile quando si vuole avere un modello sem- 
pre presente da adattare a diverse situazioni, un pò 
come giocare apunto con una bambola. Come è 
possibile ottenere quel livello di realismo visto nei 
giochi di cui abbiamo parlato all'inizio? Beh, la 
necessità aguzza l'ingegno, basta partire da un'os- 
servazione. Una volta realizzato il modello tramite 
Maya, oltre che renderizzare la figura questo pro- 
gramma può svolgere anche il ruolo di "burattinaio", 
cioè lo possiamo usare per manipolare la figura per 
farla assumere le pose che vogliamo. Allora perché 
non posizionarsi ad un livello intermedio tra quello 
tutto grafico e quello tutto runtime? Tramite Maya 
renderizziamo il modello e si memorizzano i suoi 
possibili movimenti in pose senza però realizzare il 
filmato. Il grosso lavoro di grafica è già bello che 
fatto, dato che il legame corpo -scheletro è pronto e 
le pose sono state riprese. A questo punto il modello 
può essere importato da opportuni software in mo- 
do da agirci in runtime lavorando sulle diverse pose. 



ANIMADEAD 

Animadead è una libreria che consente di utilizzare 
all'interno di un'applicazione su modello 3D pro- 
prio a questo livello intermedio. È scritta interamen- 
te in C++ ed è indipendente dalla piattaforma, per 
cui si adatta molto bene a diverse piattaforme. Inol- 
tre è un progetto Open Source, distribuita sotto li- 
cenza GNU LGPL (versione 2.1), quindi completa- 
mente gratuito e può trovare impiego anche in 
ambito commerciale, distribuendo oltre all'applica- 
zione che contiene la libreria anche il file di licenza. 
Il cuore di questa libreria è FOpenGL e la Simple Di- 
rectMedia Layer (vedere il relativo box). 
La distribuzione della versione 2.0 di Animadead (il 



file animadead-2.0.tar e lo si può trovare all'indiriz- 
zo http://animadead.sourceforge.net) contiene i sor- 
genti C++ della libreria e di un esempio di utilizzo, 
un plug-in di esportazione per Maya e due rilasci 
per aiutare la compilazione in ambiente Win32, uno 
per Visual Studio .Net 2003 e l'altro per Dev-C++. 



COMPILARE SOL 

Come già detto, la distribuzione non comprende 
l'SDL; faremo uso della versione dei sorgenti della 
versione 1.2.9, necessari per ottenere anche nel caso 
dell'SDL una libreria di runtime. Estraendo il conte- 
nuto del file di distribuzione, SDL-1.2.9.zip, trovere- 
mo un altro archivio (VisualC.zip) contenente la so- 
lution di compilazione sdl.sln. Questa solution è 
stata realizzata per una vecchia versione di Visual 
Studio: infatti, eseguendo il file ci verrà richiesta se 
vogliamo effettuarne la conversione ma possiamo 
tranquillamente confermare e proseguire in quanto 
è in questa operazione non darà problemi. Conver- 
tita e aperta la solution possiamo effetturare la com- 
pilazione in modalità Release, ottenendo le libreria 
SDL.lib e SDLmain.lib che troveremo rispettiva- 
mente nelle cartelle ..\SDL\ Release e ..\SDL- 
main\Release. A questo punto basterà copiare que- 
sti file all'interno della cartella lib presente nella 
directory in cui abbiamo estratto la distribuzione; in 
questa cartella avremo quindi le tre librerie di runti- 
me necessarie al proseguio, animadead.lib, SDL.lib 
e SDLmain.lib. 



ESEMPIO: IL BOXMAN 

Per verificare che tutto è andato a buon fine, apria- 
mo la solution dell'esempio demo fornito con la di- 
stribuzione e proviamo a compilarlo. Noteremo su- 
bito che c'è qualcosa che non va: Visual Studio ci se- 
gnalerà subito l'assenza di alcuni file, tutti relativi 
all'SDL. Questo problema discende sempre dall'as- 
senza nella distribuzione della libreria SDL, ma esi- 
ste una soluzione: basta andare sulle proprietà del 
progetto demo attraverso il Solution Explorer di 
Visual Studio, scegliere la voce Additional Include 
Directories nel campo C/C++ delle Configuration 
Propeties e premere sul pulsante sulla riga. Nella 
finestra aperta, aggiungete una nuova linea (il pul- 
sante con il simbolo della cartella), indicate il per- 
corso della cartella include presente nella distribu- 
zione dell'SDL ed il gioco è fatto. Se riprovate a com- 
pilare la solution, questa volta Visual Studio segne- 
lerà qualche warning ma nessun errore, segnale che 
questa volta tutto è andato a buon fine. Nella cartel- 
la demo troveremo adesso l'eseguibile demo.exe. La 
libreria dinamica SDL.dll era già stata caricata in 
precedente al momento di estratte l'archivio conte- 





COMPILARE 
ANIMADEAD 

Per ottenere una libre- 
ria funzionante di Ani- 
madead è necessario 
prima compilare i sor- 
genti disponibili. L'ope- 
razione è abbastanza 
semplice anche se stret- 
tamente legata alla 
piattaforma su cui si 
sta lavorando. Ad 
esempio, lavorando 
sotto Windows e aven- 
do a disposizione Vi- 
sual Studio .Net 2003 si 
può utilizzare diretta- 
mente la solution di 
compilazione rilasciata 
insieme alla distribu- 
zione. Estraiamo l'ar- 
chivio VS.NET_2003.zip 
nella stessa cartella in 
cui abbiamo estratto la 
distribuzione di Anima- 
dead, eseguiamo la so- 
lution animadead. sin e 
lanciamo una compila- 
zione in modalità Re- 
lease al termine della 
quale troveremo nella 
cartella della distribu- 
zione una nuova direc- 
tory lib contenente la 
libreria di runtime ani- 
madead.lib. 
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OPEMGL 

Da Open Graphics 

Library, ossia libreria 

aperta di grafica) è 

una specifica che 

definisce una API per 

più linguaggi e per più 

piattaforme per 

scrivere applicazioni 

che producono 

computer grafica 2D e 

3D. Attraverso 

l'interfaccia si possono 

disegnare complesse 

scene tridimensionali a 

partirà da semplici 

primitive. È usato per 

sviluppare 

nell'industria dei 

videogiochi (nella 

quale compete con 

Direct3D su Microsoft 

Windows), per 

applicazioni di CAD, 

realtà virtuale, e CAE. 

È lo standard di fatto 

per la computer 

grafica 3D in ambiente 

Unix. 



nete la solution di compilazione di Animadead. 
Dobbiamo ricordarci sempre che questa libreria va 
copiata sempre nella cartella in cui si troverà l'ese- 
guibile dell'applicazione in quanto è necessaria al 
suo funzionamento. Lesempio demo usa un model- 
lo di una figura umanoide di cui possiamo control- 
larne il movimento in un campo usando i tasti a, s, d 
e w; tenendo premuto il pulsante sinistro del mouse 
si può controllare il movimento delle braccia spo- 
stando il puntatore mentre tenendo il pulsante 
destro si può controllare la posizione delle luci di 
campo. Dando un'occhiata ai modelli usati nell'e- 
sempio troviamo una serie di file .ada ed un unico 
.adm. Quest'ultimo contiene le meshes del modello, 
la struttura "fisica" della figura, composta dall'ossa- 
tura e dal rivestimento ad essa legata. I vari .ada 
invece corrispondono alle animations, cioè alle 
varie pose per unità di tempo controllabili dall'uten- 
te. Quello che è veramente disarmante è l'estrema 
semplicità con cui lavora Animadead sul modello, 
attraverso pochi passi. 



IL MODELLO 

Partendo da un'animazione già esistente, ottenuto 
seguendo la tecnica vista prima, la prima cosa da 
fare è quello di costruirci una classe modello con cui 
interagire. Questa classe modello non deve far altro 
che caricare le informazioni sulle meshes 



model->AddMesh(DEMOSRCDIR 

"models/boxman/boxman.adm"); 

e sulle animations previste 

anim[0] = model->AddAnim(DEMOSRCDIR 

"models/boxman/WalkNW.ada"); 


anim[l] = model->AddAnim(DEMOSRCDIR 

"models/boxman/WalkN.ada"); 


anim[2] = model->AddAnim(DEMOSRCDIR 

"models/boxman/WalkNE.ada"); 


anim[3] = model->AddAnim(DEMOSRCDIR 

"models/boxman/WalkW.ada"); 


anim[4] = model->AddAnim(DEMOSRCDIR 

"models/boxman/WalkO.ada"); 


anim[5] = model->AddAnim(DEMOSRCDIR 

"models/boxman/WalkE.ada"); 


anim[6] = model->AddAnim(DEMOSRCDIR 

"models/boxman/WalkSW.ada"); 


anim[7] = model->AddAnim(DEMOSRCDIR 

"models/boxman/WalkS.ada"); 


anim[8] = model->AddAnim(DEMOSRCDIR 

"models/boxman/WalkSE.ada"); 


anim[9] = model->AddAnim(DEMOSRCDIR 

"models/boxman/twistflail.ada"); 



partiti dall'utente. Ad un comando viene associata 
una "reazione" del modello, cioè una posa e quindi 
un'animazione: il programmatore deve soltanto ri- 
chiamare la funzione Calcitiate sull'animazione 
passando la posa 

anim[i]->Calculate(model->renderPose); 



L'EMGiniE 

All'Engine viene invece delegata la gestione della 
posizione del modello e della scena in base ai co- 
mandi dell'utente. La cosa avviene regolando dei 
parametri di coordiante spaziali x, y z e la scelta 
della posa sul modello. Ad esempio, la pressione del 
tasto s fa indietreggiare la figura. Come avviene ciò? 
L'engine cattura i comandi dell'utente tasto e impo- 
sta il valore di due variabili user_x e userjy sul mo- 
dello boxman e poi chiede al modello di aggiornarsi 
boxman->Update. Il modello sa quale delle n ani- 
mazioni previste deve prendere in funzione del va- 
lore user_x e userjy e richiama su di essa il metodo 
Calcitiate usando la renderPose del modello per dare 
la nuova posa. Fatto ciò il modello aggiorna la sua 
posizione agendo semplicemente sulle coordinate 
x, y e z per ottenere l'effetto movimento. 



ESEMPIO: L'EAGLE 

Passare da un modello ad un altro è veramente sem- 
plice, basta modificare veramente poche cose. Pren- 
diamo l'esempio realizzato usando Animadead alle- 
gato alla rivista (demo_eagle.zip): in questo caso il 
modello è quello di un'aquila realizzata mediante la 
tecnica dell'armatura. Da una parte abbiamo sem- 
pre le meshes (il file eagle.adm) e dall'altra le anima- 
tions associate (eagle.ada). Realizziamo la classe 
modello nel modo seguente: 

#include "eagle.h" 
#include "animadead. h" 
#include "SDLtexture.h" 
//#include "vector3.h" 

#ifdef WIN32 

#include <windows.h> 

#endif // WIN32 

#ifdef HAVE_APPLE_OPENGL_FRAMEWORK 

#include <OpenGL/gl.h> 

#else 

#include <GL/gl.h> 

#endif 

#include <math.h> 

// this is used for linux builds so that the data can 

// stili be accessed if the 

// project is built in another directory. 



e gestire il Draw e Y Update in base ai comandi im- #ifndef demosrcdir 
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#define DEMOSRCDIR 



break; 



#endif // DEMOSRCDIR 
#include <string> 



using namespace std; 
Eagle::Eagle() : x(0), y(0), z(0) 



{ texturejoader = new Texturel_oader(); 

model = new SuperModel(ad:: Model ::DEFORMABLE, 

texturejoader); 
//anim = model->AddAnim(DEMOSRCDIR "bird/still.ada"); 
anim = model->AddAnim(DEMOSRCDIR 

"model_eagle/eagle.ada"); 
model- >AllocateRenderPose(); 
//model->AddMesh(DEMOSRCDIR "bird/bird.adm"); 
model->AddMesh(DEMOSRCDIR 

"model_eagle/eagle.adm"); } 
Eagle::~Eagle() 
{ if (model) delete model; 

if (texturejoader) delete texturejoader; } 
void Eagle::Draw() 
{ glPushMatrix(); 
grrranslatef(x,y,z); 

glRotatef(heading, 0,1,0); 

model->Draw(); 
glPopMatrix(); } 
void Eagle::Update(float time) 
{ model->Update(time); 

anim->Calculate(model->renderPose); 



L'update del model non farà altro che passare alla 
posa successiva. NelFengine gli unici Eventa, cui fac- 
ciamo reagire il modello è sul movimento del mouse 
(se il pulsante sinistro è tenuto premuto l'aquila 
ruoterà nella direzione del movimento, se invece ad 
essere premuto si sposterà la posizione della luce di 
campo) e all'ESC (che farà terminare l'applicazione) 

void Engine: :Events() 
{ static bool mbuttondownl = false; 
static bool mbuttondown2 = false; 
static bool mbuttondown3 = false; 
static bool altmod = false; 
SDL_Event event; 
while( SDL_PollEvent(&event) ) 
{ switch( event. type ) 

{ case SDL_KEYDOWN: 

if (event. key.keysym.sym == SDLK_RALT || 

event. key.keysym.sym == SDLK_LALT) 
{ altmod = true; } 
else 

HandleKey(event. key.keysym.sym, true); 
break; 

case SDL_KEYUP: 

if (event. key.keysym.sym == SDLK_RALT 

|| event. key.keysym.sym == SDLK_LALT) 
{ altmod = false; } 
else 
HandleKey(event. key.keysym.sym, false); 



case SDL_MOUSEBUTTONDOWN: 



if (event. button.button = = 

SDL_BUTTON_LEFT) 



mbuttondownl = true; 



else if (event. button.button = = 

SDL_BUTTON_RIGHT) 



mbuttondown2 = true; 



else if (event. button.button = = 

SDL_BUTTON_MIDDLE) 



mbuttondown3 = true; 



SDL_WM_GrabInput(SDL_GRAB_ON); 



break; 



case SDL_MOUSEBUTTONUP: 



if (event. button.button 



SDL_BUTTON_LEFT) 



mbuttondownl = false; 



else if (event. button.button = = 

SDL_BUTTON_RIGHT) 



mbuttondown2 = false; 



else if (event. button.button = = 

SDL_BUTTON_MIDDLE) 



mbuttondown3 = false; 



break; 



case SDL_MOUSEMOTION: 



if (altmod) 



{ if (mbuttondownl) Rotate( 

event. motion.xrel, event. motion.yrel); 
if (mbuttondown2) Zoom( 

event. motion.xrel, event. motion.yrel); 
if (mbuttondown3) Pan(event. motion.xrel, 
event. motion.yrel); 
} else 
{ if (mbuttondownl) Rotate2( 

event. motion.xrel, event. motion.yrel); 
if (mbuttondown2) Rotatel_ight( 

event. motion.xrel, event. motion.yrel);} 
break; 

case SDL_QUIT: 

throw(O); 
break; } } 
T~ 

Compilando la solution e mandando in esecuzione 
il file demo_eagle.exe, presente nella cartella princi- 
pale, l'aquila prenderà il volo. 



CONCLUSIONI 

Abbiamo visto con che semplicità possiamo integra- 
re l'engine in una qualsiasi applicazione scrivendo 
pochissime linee di codice e senza troppi sforzi di 
programmazione. L'importante è avere un buon 
modello su cui lavorare e ricordarsi di aggiungere la 
libreria dinamica dell' SDL (e relativo file di licenza) 
ad ogni nostra distribuzione. 

Antonino Panella 





PLUG-IN 

Animadead supporta 
un formato proprieta- 
rio in cui le informazio- 
ni dell'animazioni del 
modello sono separate 
in meshes (la struttura 
geometrica) e le ani- 
mations (i movimenti). 
Al momento, con la 
versione 2.0 è disponi- 
bile soltanto un plug-in 
che consente di utiliz- 
zare Maya come am- 
biente di sviluppo dei 
modelli, ma altri sono 
in fase di realizzazione, 
inclusi i plug-in per 3D 
Studio Max e Lightwa- 
ve e saranno presto 
disponibili con la ver- 
sione 3.0 di Anima- 
dead. 




ULWEB 



Ultima release di 
Animadead: 

http://animadead 
.sourceforge.net 

La libreria SDL: 

http://www.libsdl.org 

L'ambiente Dev-C++: 

http://www.bloodshed 
.net/dev/index.html 
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MOBILE T I Aggregatore di feed per dispositivi mobili con J2ME e PHP 



AGGREGATORE DI FEED 
RSS PER CELLULARI 

VEDREMO COME PROGETTARE E SVILUPPARE UN AGGREGATORE DI CONTENUTI 
PUBBLICATI TRAMITE FEED RSS CHE POTRÀ ESSERE INSTALLATO SUI COMUNI 
TELEFONI CELLULARI MODERNI 
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Conoscenze richieste 



■ — Medie di J2ME e PHP 

u 



J2ME Wireless Toolkit 
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o cosa una buona parte di voi starà pen- 
sando: "Di nuovo un articolo sui feed RSS?!". 
Infatti, la maggior parte di noi program- 
matori è stufa di sentire parlare di questo "dia- 
letto" deirXML. Questo articolo, però, si con- 
traddistingue dagli altri per un importante mo- 
tivo. Vedremo, infatti, come sviluppare una sem- 
plice ed efficace applicazione orientata ai di- 
spositivi mobili che ci permetterà di ricevere e 
visualizzare i contenuti dei feed RSS su un co- 
munissimo cellulare a patto che supporti Java. 



LA MOSTRA 
APPLICAZIONE 

Emerge dalla premessa che la nostra applica- 
zione sarà di tipo client/ server. Il client sarà rap- 
presentato da un'applicazione sviluppata uti- 
lizzando J2ME e che sarà installata su un cellu- 
lare. Il server sarà costituito da un paio di file 
scritti in PHP che saranno installati su un Web 
server e che si occuperanno di recuperare le no- 
tizie dai feed RSS. La Figura 1 dovrebbe chiari- 
re il concetto. 





Tipo di News^ 


Server 


Client 


News 











Fig. 1: Comunicazione tra client e server. Il client 
richiede un tipo di notizia al server e quest'ultimo 
estrae, dal feed RSS adatto, le news richieste 



LATO SERVER 

Come accennato, il lato server sarà sviluppato 
in PHP. Sul numero 95 di ioProgrammo (quello 
di Ottobre 2005 per intenderci) è stato pubbli- 
cato un articolo in cui venivano evidenziati i 



vantaggi che era possibile trarre dall'interazio- 
ne J2ME/PHP al posto di J2ME/J2EE. Per tale 
ragione, non entreremo di nuovo nel dettaglio 
dell' argomentazione. Per chi avesse perso quel 
numero della rivista (e questo è male!) ripetia- 
mo solo i vantaggi principali: 

• PHP è ampiamente supportato dalla stra- 
grande maggioranza dei Web server. 

• PHP è open source e quindi dispone di una 
vasta community di programmatori che pub- 
blicano codice con filosofia open. 

• La curva di apprendimento di PHP è, senza 
alcuna ombra di dubbio, più bassa rispetto 
aJ2EE. 

Detto ciò, se per qualsiasi motivo voleste uti- 
lizzare un'altra tecnologia lato server, al posto di 
PHP, siete liberi di farlo poiché per la nostra ap- 
plicazione non farà alcuna differenza. Questo 
perché client e server comunicheranno attra- 
verso un protocollo conosciuto da entrambi ed 
ampiamente supportato: HTTP. Se vi trovate più 
a vostro agio con l'ambiente .NET, potrete anche 
scrivere il lato server in ASP.NET! La cosa più 
importante è che il server restituisca al client 
una stringa in un particolare formato che ve- 
dremo tra poco. 

Lo script PHP atto a ricevere la richiesta dal 
client è RSS.php; ecco il codice: 

<?php 

require("./RSSParser.php"); 

$channels = array("Calcio" => "http://rss.kataweb.it 
/news/calcio/index, rss", "Sport" =>"http://rss 
.kataweb.it/news/sport /index. rss", 
"Informatica" => "http://punto-informatico.it 
/fader/pixml.xml", "Ultima Ora" => 
"http://rss.kataweb.it/news/nazionali 
/index. rss"); 
$channel = $_GET["channel"]; 
$url = $channels["$channel"]; 
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$news = parseRSS($url); 



echo $news; 



L'array $channels effettua il mapping tra il tipo 
di notizia (Calcio, Sport, ecc.) ed il feed RSS re- 
lativo. Il file RSSParser.php contiene il codice 
atto ad effettuare il parsing del feed RSS. Esso, 
per ragioni di spazio, non sarà esaminato in det- 
taglio in quanto è un argomento già trattato e ri- 
trattato. Quello che è necessario sapere, in que- 
sto contesto, è che dato un tipo di notizia, i no- 
stri script lato server estrarranno titoli e de- 
scrizioni di ogni news presente nel feed RSS cor- 
rispondente e li restituiranno al client nel se- 
guente formato: 



<t>Titolo del primo articolo</t> 



<d>Descrizione del primo articolo</d> 
<t>Titolo del secondo articolo</t> 
<d>Descrizione del secondo articolo</d> 



In particolare, è la funzione parseRSS (definita 
in RSSParser.php) ad effettuare il parsing e re- 
stituire la stringa appena vista. Abbiamo deci- 
so di "restringere" le news in questo modo per 
due motivi principali: 

• Minore è il numero di byte che il cellulare 
riceve dal server e minore è il costo dell'o- 
perazione (questo salvo contratti particola- 
ri col gestore di rete mobile). 

• L'applicazione è più performante se la quan- 
tità di byte da scaricare è inferiore (questo 
a prescindere da qualsiasi contratto parti- 
colare col gestore di rete mobile!). 

Chiaramente sarà compito del client, ovvero 
dell'applicazione J2ME, estrarre le informazio- 
ni di interesse da quella stringa e mostrarle in ma- 
niera convenevole all'utente. 



Classe 


Responsabilità 


News 


Rappresentare una news 


NewsFetcher 


Comunicare col server e recuperare 
le news 


NewsParser 


Estrarre le news dalla stringa ricevuta 
dal server 


WirelessNews 


GUI dell'applicazione, ovvero la midlet 


Tabella h Classi e relative responsabilità. 




zione e le relative responsabilità. La classe News 
è abbastanza semplice ed inizia come segue: 



class News 


{ 


String title; 


String description; 


public News(String 


title, 


String description) 


{ 


this. title = title; 


this. description = 


= description; 


} 


[-] 


} 




I TUOI APPUNTI 



Come si può vedere una news è rappresentata 
da titolo e descrizione. Il resto della classe è co- 
stituito dai classici metodi "getter" e "setter" re- 
lativi a titolo e descrizione. 
Nei paragrafi successivi saranno esaminate le 
restanti classi che costituiscono la nostra ap- 
plicazione. Chiaramente, non sarà riportato tut- 
to il codice; lo troverete, in ogni modo, nel CD al- 
legato alla rivista. 



LA CLASSE 
WIRELESSNEWS 

Come già accennato, la classe WirelessNews si 
occupa di gestire l'interfaccia grafica (GUI). La 
nostra applicazione si può trovare in una dei 
seguenti stati: 



LATO CLIENT 

L'applicazione lato client dovrà sostanzialmente 
essere in grado di: 

• Inviare una richiesta al server comunican- 
do il tipo di news desiderate. 

• Ricevere le news in risposta dal server e vi- 
sualizzarle all'utente. 

Ovviamente, ci sarà un'interfaccia grafica che 
permetterà appunto all'utente di selezionare il 
tipo di news e visualizzarle sul cellulare. La Ta- 
bella 1 illustra le classi utilizzate dall' applica- 



A) Lista contenente i differenti tipi di news (Fi- 
gura 2) . 




Fig. 2: La nostra applicazione 
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B) Schermata che illustra una lista contenente i 
titoli delle news scaricate dal Web (Figura 3). 



MIDlet Help 




Untrusted/ Soldato Fritz 

Download/ 1 sei della camomilla 

Torvalds: no alla GPI_v3 in Linux 

Intel svela chip a 45 nanornetri 

AMD pensa al quad-core 

Netscape 8.1 , lo scaccia-spyware 

Più' robusto il firewall di Vista 

Micro-robot medici a spasso per il corpo 

Cuccioli? Meglio se robot 

Scuola, videogiochi contro l'obesita' 

Microsoft Live Labs, Google si preoccupa? 

Google in Cina? Censura fasulla 

Postano un film inedito, rischiano la galera 

P2P? Autodenuncia di massa 

Cassandra Crossing/ L'orco elettronico 

Partita Iva d'obbligo in home page? 

Ma quale disgregazione! Internet unisce 

Indietro . fi 




C) Form in cui viene visualizzata la notizia 
completa, ovvero titolo e descrizione (Fi- 
gura 4) . 




In sostanza, all'avvio dell'applicazione viene 
visualizzata la lista contenente i vari tipi di 
news: Informatica, Calcio, Sport, ecc. come mo- 
strato in Figura 2. Selezionando un tipo di news 
si avvia il processo di "fetching" delle news ve- 
re e proprie. Ovvero si comunica allo script 
RSS.php, che si trova sul Web server, il tipo di no- 
tizia desiderata. Lo script effettua il parsing del 
feed RSS corrispondente e restituisce al client 
una stringa nel formato già visto. 
A questo punto, l'applicazione sul cellulare ef- 
fettua il parsing della stringa ricevuta dal ser- 
ver e visualizza, come in Figura 3, una lista 
contenente i titoli delle notizie ricevute. Da 
questa schermata è possibile selezionare uno 



dei titoli visualizzati in modo tale da poter leg- 
gere la notizia completa, come illustrato in Fi- 
gura 4. 

Ecco le prime righe di codice della classe Wi- 
relessNews: 



public class Wireless News extends MIDlet 

implements CommandListener 


{ 


private Display display; 


private List channelsList; 


private String[] channels = 


{ 
"Calcio", "Sport", "Informatica", 


"Ultima 


Ora" 


}; 


private List titlesList; 


private Form fmDescription; 


private News[] news; 


private Command cmSelect; 


private Command cmExit; 


private Command cmBack; 


private Command cmMain; 


[■■■] 



Come detto, WirelessNews è la midlet della no- 
stra applicazione e come tale estende la classe 
MIDlet. 

Inoltre, WirelessNews implementa l'interfac- 
cia CommandListener la quale ci permette di 
gestire le azioni scelte dall'utente. L'oggetto di- 
splay ci serve per gestire il display del disposi- 
tivo. La lista channelsList è utilizzata per vi- 
sualizzare i vari tipi di news rappresentati dal- 
l'array di stringhe channels. Poi abbiamo la li- 
sta titlesList che verrà riempita con i titoli del- 
le news scaricate. Il form fmDescription è usa- 
to per visualizzare all'utente la notizia com- 
pleta, composta da titolo e descrizione. Le news 
scaricate dal server vengono inserite in un ar- 
ray di oggetti di tipo News. Le quattro dichia- 
razioni che seguono, sono i comandi che sa- 
ranno utilizzati per gestire le azioni scelte dal- 
l'utente. Vediamo, ora, come vengono gestiti 
questi comandi all'interno del metodo com- 
mandAction, l'unico definito dall'interfaccia 
CommandListener. 

public void commandAction(Command e, 

Displayable d) 

{ 

//comando Esci 
if(c == cmExit) 
{ 

destroyApp(false); 
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notifyDestroyedQ; 



//il display è la lista contenente i tipi di news 



if(d == channelsList) 



{ 



//recupera l'indice del tipo di news selezionato 
int channellndex = 

channelsList. getSelectedIndex(); 

//istanzia la classe che recupera le news 
NewsFetcher nf = new NewsFetcher( 

channels[channellndex], this); 

//mostra un alert indicante l'inizio del 

download 
showAlert("Download in corso... attendere 

prego", d); 

//avvia il download vero e proprio 
nf.startQ; 



//il display è la lista contenente 

i titoli delle news scaricate 
if(d == titlesList) 

{ 

// comando Indietro 
if(c == cmBack) 
display.setCurrent(channelsList); 
// comando Scegli -> 

mostra la notizia completa 
if(c == cmSelect) 

showDescription(news[ 

titlesList.getSelectedlndexQ]); 



} 



//il display è il form atto a 

visualizzare la notizia completa 
if(d == fmDescription) 

{ 

//comando Indietro 
if(c == cmBack) 

display.setCurrent(titlesList); 
//comando Canali (ovvero i tipi di news) 
if(c == cmMain) 

{ 

titlesList = nuli; 
display.setCurrent(channelsList); 



} 



comando cmExit il quale termina l'applica- 
zione a prescindere dal display. Se il display è 
la lista dei tipi di news, ovvero channelsList, al- 
lora se non è stato scelto cmExit l'altra unica 
possibilità è che sia stato selezionato cmSelect, 
poiché sono gli unici comandi associati a que- 
sto display. In quest'ultimo caso viene istan- 
ziato un oggetto di tipo NewsFetcher (che ve- 
dremo tra poco) passando al costruttore il tipo 
di news selezionata, ad esempio Informatica, 
e un riferimento alla midlet chiamante (this). 
In seguito, viene visualizzato un alert che in- 
dica l'inizio del download e viene avviato il fet- 
ching delle news in un thread separato. Se il 
display, invece, è la lista contenente i titoli del- 
le news, allora la selezione del comando cmSe- 
lect causa la visualizzazione del form conte- 
nente la notizia completa, ovvero titolo e de- 
scrizione. Se, invece, il comando scelto è cmBack, 
l'applicazione visualizzerà il menu principa- 
le, ovvero la lista contenente i tipi di news. Dal 
form contenente la news completa è possibile 
tornare al menu principale o al display prece- 
dente, ovvero quello contenente i titoli delle 
notizie scaricate. 



LA CLASSE 
NEWSFETCHER 

La responsabilità della classe NewsFetcher è di 
collegarsi al server, comunicare il tipo di noti- 
zia desiderato e scaricare le news vere e pro- 
prie. Lo script PHP lato server si occuperà, poi, 
di fare il parsing del feed RSS adatto e restitui- 
re le notizie come una stringa della forma: 

<t>Giocatore Alfa in prestito alla squadra 

Beta</t> 

<d> L'attaccante Alfa va alla Beta per una cifra 

pari a 1.000.000 di euro</d> 
<t>Infortunio per il portiere della Gamma</t> 
<d>Delta, portiere della Gamma, starà fermo 3 
settimane in seguito ad un'uscita azzardata 
sull'attaccante Omega</d> 

Sarà compito della classe NewsParser, che ve- 
dremo tra poco, estrarre da questa stringa i ti- 
toli (contrassegnati da <t>...</t>) e le descri- 
zioni (contrassegnate da <d>...</d>) delle news. 
La midlet WirelessNews prowederà, poi, a vi- 
sualizzarle in formato "user-friendly" all'u- 
tente. 
Ecco l'inizio della classe NewsFetcher: 




Le azioni da compiere variano secondo il di- 
splay in cui si trova l'applicazione ed il co- 
mando selezionato. L'unica eccezione la fa il 



class NewsFetcher implements Runnable 
{ 

private String channelName; 
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private String URL 




SUL WEB 



Per saperne di più sui 
feed RSS: 

http://www.xml.com/pub 

/a/2002/12/18 

/d ive-into-xml.html 



"http://localhost:8000 
/WirelessNews/RSS.php"; 



is = http.openInputStream(); 



private WirelessNews midlet; 



private String news; 

Come si può vedere, NewsFetcher implementa 
l'interfaccia Runnable in modo da effettuare il 
download delle news in un thread separato, 
evitando così di "congelare" l'applicazione du- 
rante il recupero delle news. Gli attributi della 
classe sono costituiti da: 

• una stringa, channelName, rappresentan- 
te il tipo di news desiderate; 

• TTJRL che punta allo script PHP responsa- 
bile di recuperare le news; 

• un reference alla midlet WirelessNews; 

• una stringa atta a contenere l'insieme di 
news scaricate. 

L'unica cosa da notare è il formato dell'URL. 
Nel mio caso ho impostato il Web server Apa- 
che in ascolto sulla porta 8000 dato che la por- 
ta di default, che è 80 per HTTP, era già "occu- 
pata" da US. Chiaramente, una volta caricato 

10 script PHP online, dovrete cambiare l'URL 
di conseguenza per farlo puntare all'indirizzo 
corretto. Ad esempio, l'URL potrebbe essere: 

h ttp://www. nomesìto. it/RSS. php 

11 metodo principale della classe NewsFetcher 
è getNews il cui codice è: 

private void getNews() throws IOException 

{ 

InputStream is = nuli; 

StringBuffer sb = new StringBuffer(); 

HttpConnection http = nuli; 

try 

{ 

//aggiunge il tipo di news desiderato 

all'URL 

URL += "?channel = " + channelName; 
//sostituisce i caratteri non permessi in 

un URL 

URL = EncodeURL(URL); 

//stabilisce la connessione 

http = (HttpConnection) 

Connector.open(URL); 

//imposta il metodo di richiesta a GET 

http.setRequestMethod( 

HttpConnection. GET); 
//riceve il response dal server 
if(http.getResponseCode() = = 
HttpConnection. HTTP_OK) 

{ 

int eh; 



while((ch = is.read()) != -1) 



sb.append((char) eh); 



} 



catch (Exception e) 



{ 



System. err.println("Error: " + 



e.toString()); 



networkErrorQ; 



> 



finally 



{ 



if(is != nuli) 



is.closeQ; 



if(sb != nuli) 



news = new String(sb); 



else 



news = new String(); 



if(http != nuli) 



http.closeQ; 



//estrae titoli e descrizioni dalle news 



if(news.startsWith("<t>")) 



{ 



//niente errori 



//solo a scopo di debug 



System. out.println( news); 



News[] n = (new NewsParser( 

news)).parse(); 
midlet. showTitles(n, true, channelName); 



} 



else 
{ 



//errore. Il metodo networkError() notifica 

Terrore 



networkErrorQ; 



} 



Questo metodo accoda all'URL la query string 
indicante il tipo di news desiderato. Sostitui- 
sce i caratteri non permessi in un URL (come lo 
spazio) con i caratteri adatti. Dopodiché, cer- 
ca di stabilire una connessione di tipo Http- 
Connection col server e costruisce uno Strìng- 
Buìlder con le news ricevute dal server. 
Se il download è andato a buon fine, viene ef- 
fettuato il parsing della stringa rappresentan- 
te le news tramite il metodo parse della classe 
News Parser. 

Tale metodo restituisce un array di oggetti di 
tipo News, ovvero le notizie vere e proprie. In- 
fine viene chiamato il metodo showTìtles del- 
la classe WirelessNews il cui scopo è visualiz- 
zare le notizie sullo schermo del cellulare o un 
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alert di errore in caso di fallimento. 



LA CLASSE 
NEWSPARSER 

Come già accennato, tale classe ha la respon- 
sabilità di "rimettere le cose nel giusto ordine" 
ovvero di estrarre titoli e descrizioni da quella 
stringa "grezza" ottenuta dal server. La classe 
NewsParser è stata così codificata: 

class NewsParser 



begin += 3; 



private String rawNews; 
private int index; 



public NewsParser(String rawNews) 

{ 

this. rawNews = rawNews; 

this. index = 0; 
} 
public News[] parse() 

{ 

Vector v = new VectorQ; 



//estrae le news 

while(index < rawNews. Iength()) 

{ ~ 

//estrae il titolo 

String title = extractText(index, "t"); 
//estrae la descrizione 
String description = extractText( 

index, "d"); 
News news = new News( 

title, description); 
v.addElement(news); 



News[] ret = new News[v.size()]; 
v.copylnto(ret); 
return ret; 
} 

//estrae il testo (titolo o descrizione, a 

seconda del parametro type) 
private String extra ctText( int beginlndex, 

String type) 

{ 

String startTag = "<" + type + ">"; 
String endTag = "</" + type + ">"; 



//trova l'indice di startTag in 

rawNews, a partire da beginlndex 
int begin = rawNews. indexOf( 

startTag, beginlndex); 
//avanza di 3 caratteri in modo da 

puntare al testo vero e proprio 



//trova l'indice di endTag in rawNews, a 
partire da begin 

int end = rawNews. indexOf( 

endTag, begin); 



//aggiorna il "cursore" 



index = end + 4; 



//restituisce il testo (titolo o descrizione) 



return 



rawNews. substring(begin, end); 



} 



Questa classe non richiede particolari spiega- 
zioni poiché si tratta semplicemente di mani- 
polazione di stringhe. Vengono estratti titoli e 
descrizioni delle news e viene costruito un ar- 
ray di oggetti di tipo News. 



CONCLUSIONI 

In quest'articolo abbiamo visto come svilup- 
pare sia il lato client sia il lato server di un ag- 
gregatore di feed RSS per dispositivi mobili. 
Ovviamente, l'applicazione può essere mi- 
gliorata in molti modi. Ad esempio, è possibi- 
le utilizzare RMS (Record Management System) 
per memorizzare sul cellulare le news scarica- 
te. Oppure memorizzare, sempre sul dispositivo 
mobile, il mapping tra tipo di news e URL relativo 
al feed RSS. Questo ci permetterebbe di esten- 
dere la lista dei tipi di news "dinamicamente" 
senza dover ricompilare l'applicazione. 
Lo scopo del presente articolo, era solo quello 
di dare un input al lettore il quale potrà esten- 
dere o modificare il sistema visto a proprio pia- 
cimento. 
Buon lavoro dunque. 

Alessandro Lacava 





Un feed RSS è semplicemente un 
file XML utilizzato, principalmen- 
te, per rappresentare un insieme 
di articoli. 

Uno stralcio di un feed RSS è il 
seguente: 

[■■■] 

<item> 

<title>Titolo del primo articolo 

</title> 

<description>Descrizione del 

primo articolo</description> 

<link>Link al primo articolo 

completo</link> 



</item> 



<item> 



<title>Titolo del secondo articolo 
</title> 

<description>Descrizione del 
secondo articolo</description> 

<link>Link al secondo articolo 
completo</link> 



[-] 



</item> 



[■■■] 

Ogni item rappresenta un artico- 
lo e contiene, tra le altre cose, il 
titolo, la descrizione e il link alla 
news completa. 
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VISUAL BASIC.NET 
E LA GRAFICA 

INTEGRARE GRAFICA E DATI DINAMICAMENTE NELLE PAGINE WEB UTILIZZANDO 
LE FUNZIONI GRAFICHE DEL .NET FRAMEWORK. VEDREMO COME REALIZZARE 
BOTTONI IN FASE DI RUN TIME 




Ci CD □ WEB 



^ 



mimmmmw 



REQUISITI 



■ im i l' i li im i m 

— Basi di VB.NET e delle 
- 1 funzioni GDI 



w 



sistema operativo 
Windows, US o altro 
server web che 
supporti ASP.NET, .NET 
Framework 1.1., 
Visual Studio 2003 




Agli sviluppatori Web capita frequente- 
mente di trovarsi a gestire alcune par- 
ti della grafica del sito, come la realiz- 
zazione, ad esempio, dei bottoni di un menu. 
Se pensiamo al menu di un sito web, anche 
semplice, possiamo immaginare una serie di 
bottoni che conducono alle varie pagine 
come quelli raffigurati in Figura 1. 




Fig. 1: Un tipico menu di un sito web 

Ciò comporta necessariamente di dover ela- 
borare i bottoni con un programma di grafica 
(come ad esempio Adobe Photoshop) asse- 
gnando ad ogni immagine un testo. 
L'operazione, pur non complessa, è spesso 
impossibile da realizzare per siti con un me- 
nu molto nutrito e magari con bottoni il cui 
testo cambia molto spesso (perché magari 
proveniente da un database aggiornabile dal- 
l'utente). 

La conseguenza spesso è che per siti partico- 
larmente articolati si rinuncia all'uso di grafi- 
ca per i menu per far ricorso soltanto alla for- 
mattazione offerta dai fogli di stile. 
Intendiamoci, anch'io sono per un uso più li- 
mitato possibile delle immagini nella pagina 
web, solo che preferisco che questa sia una 
scelta stilistica, non un vincolo. E poi, dicia- 
molo francamente, a volte un tocco di colore, 
soprattutto nei siti "vetrina", non guasta. 
Il problema è quindi come fare ad adattare un 
modello di un elemento grafico, ad esempio 
un bottone, ad un testo generato dinamica- 
mente. Per essere più chiari: abbiamo un 



template grafico come quello in Figura 2 e 
vogliamo che il server "ci scriva sopra" il testo 
per noi. 



Fig. 2: il template vuoto del nostro bottone 

La soluzione, in ambiente ASP.NET, sta nell'u- 
so delle librerie grafiche offerte dal Frame- 
work. Vedremo quindi com'è possibile, par- 
tendo da un template grafico di base, far sì 
che l'immagine finale, composta da un botto- 
ne e da un testo, venga generata dinamica- 
mente. 



IL NOSTRO PROGETTO 

In Visual Studio 2003 o, se preferite in Sharp - 
Develop, impostiamo un nuovo progetto di ti- 
po libreria come possiamo vedere in Figura 3. 



Tipi progetto: 



^ Progetti di Visual Basic 
Q Progetti di Visual C# 
■C3 Progetti di Visual 1# 
m-Cj Progetti di Visual C++ 

■ C~ì Progetti e 3 e distribuzione 

B-Q Altri progetti 

■Q Soluzioni di Visual Studio 
Ù PHP Projects 



j|^l Applicazione per Windows 
^Libreria di classi 

Il ifareria di controlli Windows 

I Applicazione per Smart Device 

._■! Applicazione Web ASP.NET 
^Servizio Web ASP.NET 
| Applicazione Web mobile ASP.NET 
^Libreria di controlli Web 
Applicazione console 



e in altre api 



| DynarnicButtonl 



Nome: 

Percorso: 

Il progetto verrà creato in F:\. . .\ARTICOLI\Grahca on demand per il W Z'ynamicButtor 



I F:\docume 




Fig. 3: Il nuovo progetto di libreria 

A questo punto dobbiamo aggiungere i riferi- 
menti necessari alle librerie: System.Web e 
System. Drawing; la prima ci fornirà le classi 
per interagire con l'ambiente web mentre la 
seconda ci consentirà di usare la grafica 
GDI+. 
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Imports System. Web 



Imports System. Drawing 



Imports System. Drawing. Drawing2D 



EHI 



■ NET |cOM | Progetti | 



Nome componente 



System. Configuratici 
iì. Data, oli 
I 5ystem.Data.OracleClient.dll 
.Design.dll 
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Fig. 4: Aggiunta dei riferimenti System.Web e 
System. Drawing al progetto 



Una volta preparato così l'ambiente di lavoro, 
passiamo a scrivere un po' di codice : aggiun- 
giamo al progetto una classe che chiameremo 
GraphicButton: 

Public Class GraphicButton 
Implements IHttpHandler 

Public ReadOnly Property IsReusable() As Boolean 
Implements System. Web. IHttpHandler.IsReusable 

Get 

Return False 

End Get 

End Property 

Public Sub ProcessRequest(ByVal context As 

System.Web. HttpContext) Implements 
System. Web. IHttpHandler. ProcessRequest 

End Sub 
End Class 

Questa classe rappresenta l'impalcatura della 
nostra applicazione. Notiamo subito che im- 
plementa un'interfaccia, IHttpHandler, che 
gestisce il processo Request/Response di un 
flusso http. 

In particolare la proprietà IsReusable, impo- 
stata su False, sta ad indicare che il server 
deve processare nuovamente ogni richiesta, 
mentre il metodo ProcessRequest, fornisce, 
con il parametro context, l'oggetto necessario 
per accedere a Request e Response. 
In pratica possiamo vedere il metodo Process- 
Request come il "Main" della nostra applica- 
zione, il suo punto d'ingresso. 
Per completare l'infrastruttura della classe di- 
chiariamo due variabili private a livello di 



classe che conterranno gli oggetti Request e 
Response che rappresentano appunto la ri- 
chiesta del client e la risposta del server (gli 
stessi oggetti noti peraltro in ASP e ASP.NET): 

Private Request As HttpRequest 
Private Response As HttpResponse 

Questi oggetti vengono valorizzati, all'interno 
del metodo ProcessRequest utilizzando l'og- 
getto context: 

Me. Request = context. Request 
Me. Response = context. Response 



UN TOCCO DI GRAFICA 

A questo punto occorrerà sviluppare il vero e 
proprio codice della classe ma prima , con un 
editor di immagini, disegniamo il nostro bot- 
tone vuoto. 





r 
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Fig. 5: Il bottone disegnato in Photoshop, in evidenza 
le dimensioni totali e il rettangolo che contiene il 
testo 

Come possiamo notare in figura 5 abbiamo 
annotato le misure del bottone ed in partico- 
lare le dimensioni del rettangolo interno (100 
xl6 pixel) che deve contenere il nostro testo. 
Questa immagine sarà salvata in un formato 
non compresso (ad es. BMP) nella cartella del 
progetto con un nome convenzionale: btn- 
Template.bmp. 

Torniamo adesso al nostro codice. Inseriamo 
nel corpo della una proprietà che ci permette 
di caricare la nostra Bitmap: 

Private _Template As Bitmap 

Private ReadOnly Property Template() As Bitmap 

Get 

If _Template Is Nothing Then 
_Template = New Bitmap( 

Request.MapPathCbtnTemplate.bmp" 

) , True) 

End If 



IL PROGRAMMA 
DI GRAFICA 

Come programma di 
grafica web abbiamo 
utilizzato l'insuperato 
Photoshop. Chi non 
dispone di questo 
strumento può utilizzare 
qualsiasi altro 
programma di questo 
tipo. 

Noi consigliamo l'open 
source GIMP che potete 
trovare in: 
http://www.gimp.org 
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Return _Template 



End Get 




PANORAMICA 
SULLE GDI 

Per i programmatori 
VB.NET non è facile 
trovare molte risorse 
sull'uso della GDI 
(Graphic Device Inter- 
face) dal Framework. 
Per qualche strana 
ragione la materia 
sembra "appalto" dei 
programmatori C# 
quando invece le classi 
GDI possono essere 
usate in modo pratica- 
mente identico nell'uno 
e nell'altro linguaggio. 
Una buona risorsa sul 
web è comunque 
http://www.vbdotnetheaven. 
com/Sections/GDI+.asp 



End Property 

Notiamo qui come il caricamento del file av- 
venga risalendo alla path completa del file at- 
traverso il metodo MapPath dell'oggetto Re- 
quest (non dimentichiamoci che siamo in 
ambiente Web e che la path sarà relativa alla 
radice del sito). 

A questo punto scriviamo il metodo, che chia- 
meremo DisegnaBottone, che svolge tutto il 
lavoro di scrivere il testo sul bottone. 

Private Sub DisegnaBottone() 

Dim rettangolo Botto ne As RectangleF = 

Template.GetBounds(Graphicsllnit. Pixel) 
Dim retta ngoloTesto As RectangleF = New 

RectangleF(rettangoloBottone.X + 16, 

rettangoloBottone.Y + 7, 100, 16) 

Dim testo As String = Request.QueryString("s") 



If testo = "" Then testo 



"prova" 



Dim coloreTesto As Color = Color. FromArgb( 

200, Color.White) 

Dim pennelloTesto As SolidBrush = New 

SolidBrush(coloreTesto) 
Dim formatoTesto As New String Format( 

StringFormatFlags.FitBlackBox) 



formatoTesto. Alignment 



StringAlignment. Center 



formatoTesto. LineAlignment = 

StringAlignment. Center 
Dim carattere As New Font("verdana", 14, 

Graphicsllnit. Pixel) 
Dim g As Graphics = Graphics. FromImage( 

Template) 
g.DrawString(testo, carattere, pennelloTesto, 

rettangoloTesto, formatoTesto) 
g.Dispose() 

Me.Response.ContentType = "image/jpeg" 
Template. Save(Me.Response.OutputStream, 

Imaging.ImageFormat.Jpeg) 
End Sub 

Seguiamo passo passo il codice. 
Per prima cosa ricaviamo i due rettangoli; 
dell'area occupata dal bottone (prendendola 
dalla bitmap di template) e del rettangolo in- 
terno che ospita il testo (con le misure che 
avevamo già visto in Photoshop): 

Dim rettangolo Bottone As RectangleF = 

Template. GetBounds(Graphicsllnit. Pixel) 
Dim rettangoloTesto As RectangleF = New 

RectangleF(rettangoloBottone.X + 16, 
rettangoloBottone.Y + 7, 100, 16) 

Prendiamo poi il testo da scrivere che deve 



essere passato come parametro nella stringa 
della URL (o in mancanza essere valorizzato 
con la stringa "prova"): 

Dim testo As String = Request.QueryString("s") 



If testo = "" Then testo 



"prova" 



Impostiamo poi il colore del testo e da questo 
ricaviamo il pennello grafico (notiamo come 
al colore, Bianco, sia stata aggiunta una pic- 
cola trasparenza per fondersi meglio con la 
bitmap): 

Dim coloreTesto As Color = Color. FromArgb(200, 

Color.White) 

Dim pennelloTesto As SolidBrush = New 

SolidBrush(coloreTesto) 

Impostiamo inoltre il carattere del testo e il 
formato della stringa che saranno rispettiva- 
mente: verdana a 14 pixel e centrato sia verti- 
calmente che orizzontalmente: 

Dim formatoTesto As New StringFormat( 

StringFormatFlags. FitBlackBox) 
formatoTesto. Alignment = StringAlignment. Center 
formatoTesto. LineAlignment = StringAlignment. Center 
Dim carattere As New Font("verdana", 14, 

Graphicsllnit. Pixel) 

Otteniamo l'oggetto Graphics dal nostro tem- 
plate che abbiamo caricato e andiamo a scri- 
vere la nostra stringa di testo, con i parametri 
impostati, nel rettangolo relativo: 

Dim g As Graphics = Graphics. Fromlmage(Template) 
g.DrawString(testo, carattere, pennelloTesto, 

rettangoloTesto, formatoTesto) 
g.Dispose() 

Infine salviamo la bitmap così modificata nel- 
lo Stream di output dell'oggetto Response im- 
postando prima la proprietà ContentType di 
Response come "image/jpeg": 

Me.Response.ContentType = "image/jpeg" 
Template. Save(Me. Response. OutputStream, 

Imaging.ImageFormat.Jpeg) 

Completiamo la nostra classe semplicemente 
richiamando il metodo DisegnaBottone 
all'interno di ProcessRequest: 

Public Sub ProcessRequest(ByVal context As 

System. Web. HttpContext) Implements 
System. Web. IHttpHandler. ProcessRequest 
Me.Request = context. Request 
Me. Response = context. Response 
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DisegnaBottoneQ 



End Sub 



COME L'UTILIZZIAMO? 

A questo punto anche i più pazienti tra di voi 
staranno incominciando a chiedersi: ma 
quando si passa all'azione? 
Vi accontentiamo subito. 
Ricordate che la nostra classe implementava 
IHttpHandler? Bene questo non è altro che il 
gestore "a basso livello" del meccanismo ri- 
chiesta client/risposta server in un contesto 
HTTP (IHttpHandler è utilizzato in modo na- 
scosto anche dalle pagine ASP.NET) quindi 
dobbiamo semplicemente impostare l'appli- 
cazione web e dirle che intendiamo utilizzare 
il tipo GraphicButton per gestire una partico- 
lare URL. 

Niente paura, la cosa è più difficile a dirsi che 
a farsi. 

Per prima cosa, nel server US, impostiamo 
una nuova directory virtuale, come vediamo 
in Figura 6. 



■■ E Internet Information Services 



File Azione Visualizza ? 



e m | x s 1 ® m> 



J} NB5MELZG (computer locale) | 
B-Cl Siti Web 

B -g^ Sito Web predefinito 
E--® IISHelp 

!q 

h-Q 
m 



M I ► ■ " 



Esplora 

Apri 

Sfoglia 



Dbin 
Dobj 
yJQ Assemblylnfo.vb 

|) btnTemplate.bnnp 

■) DynarnicButton.sIn 

D DynannicButton.suo 
- M DvnarnicButton.vbDroi 
Directory virtuale... L r 

D GraphicButton. vb 




Fig. 6: Impostiamo una nuova directory virtuale in US 

Nel wizard che segue impostiamo il nome 
della directory in button e gli assegniamo, co- 
me path, il percorso completo della directory 
del nostro progetto. 

A questo punto, se operiamo nel nostro com- 
puter con US installato, abbiamo disponibile 
la nostra applicazione alla URL: http:/ /locai- 
host/button. 

Sì, direte voi, ma non abbiamo creato nean- 
che una pagina ASP.NET ? 
Non è necessario. Nella directory del nostro 
progetto (che a questo punto sarà diventata 



anche la root di http://localhost/buttorì) creia- 
mo, con un semplice editor di testo o con Vi- 
sual Studio, un file web.config di questo tipo: 

<?xml version = "1.0" encoding = "utf-8" ?> 
<configuration> 
<system.web> 

<globalization requestEncoding="iso-8859-l" 
responseEncoding="iso-8859-l"/> 



<httpHandlers> 



<add path = "button.aspx" type= 

"DynamicButton. GraphicButton, 

DynamicButton" verb="*" validate= 

"false"x/add> 



</httpHandlers> 



</system.web> 



</configuration> 

Notiamo in particolare l'elemento add air in- 
terno di httpHandlers, in questo elemento 
abbiamo definito gli attributi: 

• path - che è la uri relativa all'applicazione 
che verrà gestita, in questo caso button 
.aspx che verrà richiamata come http://lo- 
calhost/ button/button.aspx. 

• type - che è composto da <tipo>,<assem- 
bly>, cioè il nome completo del tipo (o 
classe) che gestisce la richiesta (nel nostro 
caso GraphicButton completo del name- 
space DynamicButton che il progetto crea 
automaticamente) e del nome dell'assem- 
bly (DLL) che lo contiene (nel nostro caso 
anch'esso chiamato DynamicButton). 

• verb - impostato a "*" ad indicare che il 
gestore è valido per tutte le richieste 
(POST, GET ecc..) 

• validate - impostato a false che indica che 
non deve essere cercato su disco il file but- 
ton.aspx ma che esso è solo una URL con- 
venzionale. 



3 http://iocalhost/button/button.aspK - Microsoft . 
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ALTERNATIVE 
A US 

US è il web server di 
elezione per testare le 
applicazioni web create 
con .NET tuttavia il 
server non è 
disponibile per alcune 
piattaforme, come 
Windows XP Home. 
Gli utenti che non 
possono disporre di MS 
possono installare il 
web server Cassini, 
messo a disposizione 
dalla stessa Microsoft 
su http://www.asp.net 
/Projects/Cassini/Download/ 
Default.aspx?tabindex= 
0&tabid=1 



Fig. 7: La nostra libreria in funzione! 
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Francesco Smelzo è 
specializzato nello svi- 
luppo in ambiente 
Windows con partico- 
lare riferimento ad ap- 
plicazioni in ambiente 
.NET sia web-oriented 
che desktop. 
Il suo sito web è 
www.smelzo.it . 
Come sempre è a di- 
sposizione per ricevere 
suggerimenti o richie- 
ste sull'articolo all'in- 
dirizzo di posta 
elettronica 
francesco@smelzo.it 



Ed è proprio l'ultimo attributo, validate, che 
impostato su false ci consente di avere a di- 
sposizione l'output prodotto dalla nostra 
classe senza avere in realtà un file Button 
.aspx. 

A questo punto, per provare che tutto funzio- 
ni a dovere, compiliamo il progetto e nel 
browser andiamo a digitare l'URL http://local- 
host/button/button.aspx e otteniamo il nostro 
template riempito con il testo di prova. 
Facciamo quindi un'ulteriore prova aggiun- 
gendo alla URL attraverso il parametro s la 
stringa "home": http://localhost/button/but- 
ton. aspx? s -home e notiamo come il testo sul 
bottone sia cambiato (Figura 8). 



3 http://localhost/button/button.aspK?s=honie - . 
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J Indirizzo |^) http://localhost/button/button.aspx?s=home 



Fig. 8: II testo del bottone è regolato dal parametro s 
della querystring 



Ul\l PO' DI HTML 

A questo punto abbiamo capito che l'output 
della nostra classe viene trattato dal browser 
come un qualsiasi file grafico statico, per cui 
come tale potremmo utilizzarlo all'interno 
del nostro codice html. 

Per fare una prova creiamo, sempre nella root 
del sito, un semplice file HTML chiamato me- 
nu.htm inserendo le uri che puntano a but- 
ton.aspx come sorgenti di immagini e cam- 
biando soltanto il parametro s: 

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 

Transitional//EN"> 
<html> 
<head> 

<title>menu</title> 
</head> 

<body> 

<img src= "button. aspx?s= home" ><br> 

<img src= "button. aspx?s=chi%20siamo"xbr> 

<img src= "button. aspx?s= prodotti" ><br> 



</html> 

E, come risultato, possiamo ammirare la bella 
lista di bottoni presentata in Figura 9. 



3 menu - Microsoft Internet Explorer 
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Operazione 



m 



Intranet locale 



<img src= "button. aspx?s= l'azienda" ><br> 
<img src= "button. aspx?s=contatti"xbr> 



Fig. 9: Il nostro menu grafico costruito dinamicamente 



MARGINI 

DI MIGLIORAMENTO 

Non vi sarà sfuggito che la nostra classe che 
abbiamo scritto GraphicButton in un am- 
biente di produzione può essere notevolmen- 
te migliorata per aumentarne flessibilità e 
riutilizzo. 

In particolare, nel nostro esempio abbiamo 
parametrizzato soltanto il testo che viene va- 
lorizzato attraverso il parametro s della col- 
lection Request. Querystring, accodandolo in 
pratica alla uri. In tal modo però si possono 
parametrizzare anche tutti gli altri valori che 
qui sono stati scritti direttamente nel codice : 
font, dimensioni, stile e anche la stessa im- 
magine di base. 

C'è poi, per gli amanti dell'avventura, la stra- 
da più impervia di non servirsi di un templa- 
te pre-esistente, ma di disegnarlo direttamen- 
te con i metodi grafici (DrawRectangle,FillEl- 
lipse ecc.); in questo modo si possono otte- 
nere risultati davvero flessibili ed eccellenti 
soprattutto quando il pulsante si deve adatta- 
re alla lunghezza del testo. 
Tuttavia lo scopo dell'articolo era quello di 
mostrare una strada possibile per l'integra- 
zione tra grafica e dati dinamici ed una de- 
scrizione troppo dettagliata delle funzioni 
GDI ci avrebbe portato fuori obiettivo. 

Francesco Smelzo 
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IO PROGRAMMO BY EXAMPLE 

IMPARA A PROGRAMMARE IN MODO PRATICO E DIVERTENTE, CON GLI ESEMPI PASSO PASSO 
CHE TI GUIDANO ALLA COSTRUZIONE DEL CODICE 



J COME FARE 

i^.m:w DRAG'N'DROP 

DA UNA DATAGRIDVIEW 

AD UN'ALTRA pag. 48 

Un trucco utile per copiare i dati da 
una tabella ad un'altra in modo semplice 
e immediato. Vediamo come. 



clientiDataGridViewl System. Windows. Form ■* 

:: l u . 

ShowEditinglcon True 

ShovvRowErrors True 

UseWaittlursor False 
B Behavior 

AllowUserToAddRovvs True 

Allnwllm-TnT>p|ptiPRnTriiP 



consultare con un editore. Vediamo 
come. 

EXHjH CHE COSA VUOL DIRE 
r^, M ,:^« CASTING? pag. 55 

Si tratta di una tecnica che consente di 
convertire un tipo di dato in un'altro, da 
adottare con modalità particolari per 
ogni linguaggio. Vediamo come. 



COME POSSO AGGIUNGERE 
UN'IMMAGINE AGLI ELEMENTI 
DI UNA COMBOBOX? pag. 52 

Creeremo una nuova classe derivata 
dall'originale e sfrutteremo la proprietà 
DrawMode per determinare il disegno 
della combo 

H— COME POSSO 
CONVERTIRE HTML IN TESTO pag. 54 

Può capitare di voler eliminare i tag 
presenti in un testo HTML per poterlo 



EHlfflEi COME POSSO 
VISUALIZZARE L'ICONA ASSOCIATA 
AD UN FILE? pag. 56 

Utilizzeremo in modo semplice alcune 
DLL di sistema per raggiungere lo scopo, 
vedremo che è più semplice di quello 
che normalmente si pensa 



l«l:»hl QUALI SONO LE FUNZIONI 

PER MANIPOLARE STRINGHE 

IN VB.NET 2003? pag. 58 

Esistono molti comodi metodi per poter 
lavoare con le stringhe. Alcuni di essi 
hanno significati particolari. Vediamo 
quali. 



immmwhi come posso sapere se 

UN NUMERO È PARI DISPARI? pag. 58 

Un numero intero è pari se è divisibile 



per due, in caso contrario è dispari. 
Sfruttiamo questa definizione per 
recuperare l'informazione che ci serve. 



COME POSSO REALIZZARE 
APPLICAZIONI MULTILINGUE 
CON JAVA? pag. 59 

Possiamo utilizzare alcune delle 
caratteristiche peculiari del linguaggio. 
Vediamo un esempio rapido realizzato 
con Eclipse. 



COME POSSO AVERE 
INFORMAZIONI SULLE CLASSI 
CARICATE? pag. 61 

Un esempio pratico per imparare come 
vengono richiamate le classi all'interno 
di Java e come viene gestita la 
memoria. 



VUOI INVIARE UN ESEMPIO? 

Se sei un programmatore esperto ed 
hai risolto un problema, puoi 
aiutare gli altri pubblicando il tuo 
codice. Proponi i tuoi esempi 
scrivendo a 



ioprogrammo@edmaster.it 



Come contattarci? 

Alla nostra redazione arriva spesso un considerevole 
numero di email riguardante temi specifici. Per con- 
sentirci di rispondere velocemente e in modo adegua- 
to alle vostre domande abbiamo elaborato una FAQ - 
Frequently Ask Question - o risposte alle domande 
frequenti in italiano, di modo che possiate indirizzare 
le vostre richieste in modo mirato. 

Problemi sugli 
abbonamenti 

Se la tua domanda ha a che fare con una delle seguen- 
ti: 

• Vorrei abbonarmi alla rivista, che devo fare? 

• Sono un abbonato e non ho ricevuto la rivista, a 
chi devo rivolgermi? 

• Sono abbonato ma la posta non mi consegna 
regolarmente la rivista, a chi devo rivolgermi? 

Contatta abbonamenti@edmaster.it specificando 
che sei interessato a ioProgrammo. Lascia il tuo indi- 
rizzo email e indica il numero dal quale vorresti far 
partire l'abbonamento. Verrai contattato al più presto. 
Oppure puoi chiamare lo 02 831212 



Problemi sugli allegati 

Se riscontri un problema del tipo: 

• Ho acquistato ioProgrammo ed il Cdrom al suo 
interno non funziona. Chi me lo sostituisce? 

• Ho acquistato ioProgrammo ma non ho trovato il 
cd/dvd all'interno, come posso ottenerlo? 

• Vorrei avere alcuni arretrati di ioProgrammo co- 
me faccio? 

Contatta servizioclienti@edmaster.it 

Non dimenticare di specificare il numero di copertina 
di ioProgrammo e la versione: con libro o senza libro. 
Oppure telefona allo 02 831212 

Assistenza tecnica 

Se il tuo problema è un problema di programmazione 
del tipo: 

• Come faccio a mandare una mail da PHP? 

• Come si instanzia una variabile in c++? 

• Come faccio a creare una pagina ASENET 

o un qualunque altro tipo di problema relativo a 



tecniche di programmazione, esplicita la tua 
domanda sul nostro forum: http://forum.iopro- 
grammo.it, uno dei nostri esperti ti risponderà. Le 
domande più interessanti saranno anche pubblica- 
te in questa rubrica. 

Problemi sul codice 
all'interno del CD 

Se la tua domanda è la seguente 

• Non ho trovato il codice relativo all'articolo all'in- 
terno del ed 

Consulta la nostra sezione download all'indirizzo 
http://cdrom.ioprogrammo.it, nei rari casi in cui il 
codice collegato ad un articolo non sia presente nel 
cdrom, senza dubbio verrà reso disponibile sul nostro 
sito. 

Idee e suggerimenti 

Se sei un programmatore esperto e vuoi proporti 
come articolista per ioProgrammo, oppure se hai sug- 
gerimenti su come migliorare la rivista, se vuoi inviar- 
ci un trucco suggerendolo per la rubrica tips & tricks 
invia una email a 
ioprogrammo@edmaster.it 
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COME FARE DRAG'N'DROP DA 
UNA DATAGRIDVIEW AD UN'ALTRA 

UN TRUCCO UTILE PER COPIARE I DATI DA UNA TABELLA AD UN'ALTRA IN MODO 
SEMPLICE E IMMEDIATO. VEDIAMO COME 



VISUAL BASIC.NET 



1 Prima di tutto una connessione a un database. 
Facciamolo con il Wizard di Visual Studio clic- 
cando sul menu "Data/Add new data source". 



rtrft Visual C# 2005 Express Edition 
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I Nella form che segue scegliamo "DataBase" e 
i poi next 
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Ch oos e a Data Source Type 



Where wìll the application get data frani? 




Lets you connect to a database and choose the database objects fi 
dataset. 



I Scegliamo "New Connection" per stabilire la 
) fonte da cui prelevare i dati 
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Choose Your Data Connection 



Which data connection should your application use to connect to the database? 

| ^J \ New Connection,., 

This connection string appears to contein sensitive data {far example, a password), which is required to 
connect to the database. However, storing sensitive data in the connection string can be a security risii, Do 
you want to indude this sensitive data in the connection string? 

\ • No, esclude sensitive data ftom the connection string. I will set this information in my application code, 

Yes, include sensitive data in the connection string, 

lil Connection string 



< Previous Cancel 
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4 Nella form che segue selezioniamo il tipo di 
database a cui fare il binding e ovviamente la 
fonte dei dati 




This connection strini 



Enter information ;o :o-- s:: ::■ re see::ed data source or 
didt'Change' to :- _ oose ? l - ^e-ent data source and/or 
provider. 
Data source: 



licrosoftSQL 



Server Database 



File (SqlClient) [ Change... 



■Jew Connection. 



Database file name [new or existing): 



C:',smart'.SmartEstate,mdf 
you want to indude 1 ' 



1 No, exdude 5 

Yes, indude s 

{+} Connection strin 



[ 



Log on to the server 

Use Windows Authentication 

O Use SQL Server Authentication 

User nanne: | 

Password: 



ny application coi 



I I Save my password 



Test Connection 



1 Confermiamo la scelta del database e prose- 
' guiamo cliccando su Next 



Choose Your Dita Connection 



WtUtfi (Ut» com«tW)n f houM ixkii ipobcitm uh tv connect to ti 



v f h- 



»"' i 



WWW 



i Salviamo la stringa di configurazione e andia- 
I mo avanti 



4» 



Save the Connection String to the Application Configuratici! File 



S:o--c :o e: :■ i :t ■" :. =-'-' -= : .:■ "~z. = : 'e ìììsì r e = .e = : :ej :■ e : sfve e 
:o'":":e:io-": si-.r.z - re;;: :~;o-" :o'" £ c. , ;:" £ e.e , ";e';'"7"e ■" ;■"; sx ;-; ;-~e-~ : :-'.ex;. 
Do vou want to save the connection string to the application configura tion file? 
@ Yes, save the connection as: 
IsmartEstateConnectionString 



| < Previous ] | Next > J Finish ] | Cancel 
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I Scegliamo le tabelle da importare e terminiamo 
il Wizard. 



-i. 



Choose Your Database Objects 



Which database oo;e::s co e. . r-; inyour dataset? 



H'-Bftl Tables 
É-H E3 agenti 
©■■03 Agenzie 
ÉB 3 Clienti 
B-03 Contratti 
S-03 Immobili 
É-B 3 Offerte 
Ì"EB Preventivi 

+ J Tipol oo e 

É J TipoOffertalmmobile 
É-B l3 Trattative 
QCfe Wews 

j S:o-sc -■■02C.-K 
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8 Trasciniamo dal dataset sulla form la tabella 
che ci interessa e creiamone una che disponga 
di almeno due campi uguali a quelli della tabella 
sorgente 



='. 




* 



j. 

■ 



: ' 



I Nella griglia di destinazione settiamo a true la 
' property "AllowDrop" 



J 
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AllowUserToAddRows True 
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AHowUserToQrderCol False 
AllowUserToResizeCo True 




__!, clientiTableAdapter 
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ColumnHeadersHeigh EnableResizing 
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4| {% Nella griglia sorgente clicchiamo due volte 
I w sull'evento "MouseDown" per generarne il 
codice di gestione 
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Il codice da inserire è il seguente 



private void clientiDataGridView_MouseDown( 

object sender, MouseEventArgs e) 
{ 

if (e.Button == MouseButtons.Right) 
{ 

DataGridView.HitTestlnfo info = 

clientiDataGridView.HitTest(e.X, e.Y); 



if (info.RowIndex >= 0) 
{ 



DataRowView row = (DataRowView) 

clientiDataGridView. Rows[info.RowIndex] 
.DataBoundltem; 



if (row != nuli) 



clientiDataGridView. DoDragDrop( 

row, DragDropEffects.Copy); } } 



} 



4| ^ Nella datagrid destinazione gestiamo prima 
I fc l'evento DragEnter, generando il template di 
gestione, cliccando due volte sulla voce che lo rap- 
presenta. Il codice da inserire è il seguente: 

private void clientiDataGridViewl_DragEnter( 

object sender, DragEventArgs e) 
{ e.Effect = DragDropEffects.Copy; } 

4| ^ Infine gestiamo l'evento DragDrop che al 
I J rilascio del pulsante del mouse copia fisica- 
mente i dati selezionati 

private void clientiDataGridViewl_DragDrop( 

object sender, DragEventArgs e) 
{ 

if (e.Data.GetDataPresent( 

typeof(DataRowView))) 
{ DataRowView row = (DataRowView)e. 
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Data.GetData(typeof(DataRowView)); 
clientiDataGndViewl.Rows.Add( 

row["Nome"].ToString(), 
row["Cognome"].ToString()); } 



COME FUNZIONA? 

Prima di ogni viene impostata a true la property 
AllowDrop che rende attiva la possibilità di gestire 
il drag & drop sulle due grid. Alla pressione del 
tasto destro del mouse sulla datagrid sorgente 
viene invocato l'evento MouseDown che controlla 
che la riga selezionata contenga almeno qualche 
dato. Se la riga non è nulla la copia in un buffer. 
Quando il bottone del mouse viene rilasciato ven- 
gono aggiunti i dati alla griglia di destinazione. 

I^H FACCIAMOLO 
IN VISUAL BASIC 

II passi da uno a dieci rimangono identici a 
quelli utilizzati per C#. Il codice di gestione 
dell'evento MouseDown diventa 

Private Sub ClientiDataGridView_MouseDown( 

ByVal sender As System.Object, ByVal e As 

System.Windows.Forms.MouseEventArgs) 

Handles ClientiDataGridView. MouseDown 

If e.Button=Windows.Forms.MouseButtons.Right Then 

Dim info As DataGridView.HitTestlnfo = 

ClientiDataGndView.HitTest(e.X, e.Y) 
If (info.RowIndex >= 0) Then 

Dim bound As Integer = info.RowIndex 
Dim tmp As Object = ClientiDataGridView. Rows( 
bound). Data Boundltem 



Dim row As DataRowView = CType( 

tmp, DataRowView) 
If Not row Is Nothing Then 
ClientiDataGridView. DoDragDrop( 

row, DragDropEffects.Copy) 

End If 

End If 

End If 



211 codice di gestione dell'evento DragEnter 
diventa 

Private Sub DataGridViewl_DragEnter(ByVal sender 

As System.Object, ByVal e As 

System.Windows.Forms.DragEventArgs) 

Handles DataGridViewl. DragEnter 

e.Effect = DragDropEffects.Copy 

End Sub 

3 Infine il codice di gestione dell'evento Drag- 
Drop si può riscrivere come segue 

Private Sub DataGridViewl_DragDrop(ByVal sender 
As System.Object, ByVal e As 
System.Windows.Forms.DragEventArgs) 
Handles DataGridViewl. DragDrop 
If (e.Data.GetDataPresent(GetType( 

DataRowView))) Then 



Dim tmp As Object 



e.Data.GetData( 
GetType(DataRowView)) 



Dim row As DataRowView = CType( 

tmp, DataRowView) 
DataGridViewl. Rows.Add(row("Nome") 

.ToString(), row("Cognome").ToString()) 

End If 

End Sub 



COME POSSO AGGIUNGERE 
UN'IMMAGINE AGLI ELEMENTI 
DI UNA COMBOBOX? 

CREEREMO UNA NUOVA CLASSE DERIVATA DALL'ORIGINALE E SFRUTTEREMO LA PROPRIETÀ 
DRAWMODE PER DETERMINARE IL DISEGNO DELLA COMBO 



Clicchiamo su "File/New Project" e poi 
scegliamo class library 



Templates: 






^™ 


Visual Studia insta lied templates 




■ 

Screen Saver 
Starter Kit 


.1 

Movie 
Collecti... 


53 ■ 9j 

Application Application 
My Templates 


SI 

Ernpty Project 


^^ 



2 Clicchiamo con il tasto destro del mouse sul 
Solution explorer e di seguito alla voce "Add 
/Reference" 



^ Solution 'dassLibrary 1' (1 project) 






Add Web Reference.. 
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i Nella dialog box che compare selezioniamo 
* System.Windows.Form e System. Drawing 




4 In alto nel codice aggiungiamo gli import 
corretti 

using System; 

using System. Collections.Generic; 

using System. Text; 

using System. ComponentModel; 

using System. Drawing; 

5 Clicchiamo con il tasto destro del mouse nel 
solution explorer alla voce add/new item 
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i Nella dialog box che compare selezioniamo 
I class 
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! Nella nuova classe che abbiamo così definito 
aggiungiamo il seguente codice 



public class ImageComboItem : Component 
{ 

private Object m_object; 

private Image m_Image; 

public ImageComboItem(object item, Image img) 

{ 

m_object=item; 
m_Image=img; 



[TypeConverter(typeof(StringConverter))] 

public Object Item 

{ 

get{ return m_object;> 

set{m_object = value;} 



public Image Image 

{ 

get{return m_Image;> 
set{m_Image = value;} 

} 

public override string ToString() 

{ 

if (m_object == nuli) 

return String. Empty; 
else 

return m_object.ToString(); 



} 



8 Infine nella classe primaria aggiungiamo il 
seguente codice e compiliamo il tutto tramite il 
menu build 

public class ImageCombo : 

System. Windows. Forms.ComboBox 
{ 

private System. ComponentModel. Container 



COME PROVARE LA NUOVA CLASSE 

Aprite un nuovo progetto e cliccate con 
il tasto destro del mouse su un punto 
vuoto della tabsheet. Selezionate dal 
menu a tendina che comparirà la voce 
"Add lab". Nella dialog box che segue 
selezionate "Browse" e cercate nel 
vostro hard disk la dll che avete creato 
in precedenza. 

La nuova dll comparirà nei tool con 
l'icona di una ruota dentata. 
Trascinatela sulla form e in relazione 
all'evento onload della form 
aggiungete il seguente codice 



private void Forml_Load( 

object sender, EventArgs e) 
{ 

imageCombol.Items.Add( 

new ImageComboItem( 

"itemi", Image. FromFile( 

@"c:\immagine.bmp") 

)_)}_ 

} 

non dimenticate di aggiungere la 
direttiva using ClassLibratyV, all'inizio 
del vostro codice. 
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components = nuli; 



public ImageComboO 



{ base.DrawMode = DrawMode.OwnerDrawVariable;} 
protected override void Dispose( bool disposing ) 



{ 



if( disposing ) 



{ 



if(components != nuli) 



{ components. Dispose();> 



if (this.Items != nuli) 



{ 



foreach (Object o in this.Items) 



{ 



if (o is ImageComboItem) 



((ImageComboItem)o).Dispose(); 



} 



base.Dispose( disposing ); 



} 



private int currentlndex = -1; 



protected override void OnDrawItem( 

DrawItemEventArgs e) 



{ 



if (e. Index == -1 1 1 e. Index 

> this.Items. Count - 1) 



return; 



e.DrawBackgroundQ; 



Rectangle imageRect = new Rectangle( 

e.Bounds.X, e.Bounds.Y, .Bounds.Height, 

e.Bounds.Height); 

RectangleF textRectF = RectangleF.Froml_TRB( 

imageRect. Right + 2, e.Bounds.Top, 

e.Bounds.Right, e.Bounds.Bottom); 

if (Items[e. Index] is ImageComboItem ) 



{ 



ImageComboItem Item = 

(ImageComboItem)Items[e. Index]; 



if (Item.Image != nuli) 



e. Graphics. DrawImage(Item.Image, 

imageRect); 



} 



SolidBrush TextBrush = new 



SolidBrush(this.ForeColor); 



if ((e. State & DrawItemState.Selected) 

= = DrawItemState.Selected) 
TextBrush. Color = SystemColors.HighlightText; 
StringFormat sf = new StringFormat( 

StringFormatFlags.NoWrap); 
sf.LineAlignment = StringAlignment. Center; 
sf.Trimming = 

StringTrimming.EllipsisCharacter; 
e. Graphics. DrawString( 

Items[e. Index] .ToStringO, this. Font, 
TextBrush, textRectF, sf); 
TextBrush. Dispose(); 
} 
protected override void 

OnSelectedIndexChanged(EventArgs e) 

{ 

if (this.Selectedlndex != this. currentlndex) 

{ 

this. currentlndex = this.Selectedlndex; 
base.Refreshltem(this.Selectedlndex); 



else 



base.OnSelectedlndexChanged (e); 



COME FUNZIONA 

Per creare una ComboBox, che oltre alle stringhe 
visualizzi un'immagine associata ad esse, dobbia- 
mo creare una nuova classe, derivandola dalla 
ComboBox standard. Come modalità di disegno 
utilizziamo il valore DrawMode.OwnerDrawVaria- 
ble, impostando la proprietà DrawMode, e ciò 
implica che saremo noi a dover gestire il disegno 
degli elementi della ComboBox, che saranno rap- 
presentati dalla classe ImageComboItem, il cui 
scopo è incapsulare il testo e l'immagine di ogni 
item. La classe ImageCombo dovrà fornire un 
override del metodo OnDrawItem per disegnare 
l'immagine di ogni Item, e di seguito la relativa 
stringa. 



COME POSSO CONVERTIRE HTML IN TESTO 



Vogliamo scrivere una funzione 
che converta una pagina HTML in 
testo puro, eliminando tutti i Tags 
HTML. Per farlo possiamo utilizzare 
lo spazio dei nomi 
System. Text.RegularExpressions. 
All'interno di System. Text.Regular- 



Expressions, sono racchiuse tutte le 
classi che consentono di accedere al 
modulo delle espressioni regolari di 
VB.NET 2003. In particolare utilizzia- 
mo la classe Regex che rappresenta 
un'espressione regolare non modifi- 
cabile. Tra i suoi metodi ci viene in 



aiuto il metodo Replace. Con il meto- 
do Replace possiamo sostituire tutte 
le ricorrenze delle corrispondenze 
definite dall'espressione regolare 
con una stringa di sostituzione, a 
partire dal primo carattere nella 
stringa di input. 
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CHE COSA VUOL DIRE CASTING? 

SI TRATTA DI UNA TECNICA CHE CONSENTE DI CONVERTIRE UN TIPO DI DATO IN UN ALTRO, 
DA ADOTTARE CON MODALITÀ PARTICOLARI PER OGNI LINGUAGGIO. VEDIAMO COME 



I FACCIAMOLO IN C# 

Una delle operazioni più comuni da effettua- 
re in un qualsiasi programma, è la conversio- 
ne di un dato da un tipo ad un altro. C# è un 
linguaggio strongly-typedy cioè fortemente 
tipizzato, dunque quando due tipi non sono 
compatibili deve essere esplicitamente indi- 
cata la conversione che si vuol eseguire. 
Ad esempio si parla di conversione implicita 
quando si vuol convertire un dato di tipo 
byte in int: 

byte b=5; 

int i = b; 

nel caso in cui non sia possibile una conver- 
sione implicita, si ricorre all'operatore di cast 
0, che si utilizza preponendolo al dato da 
convertire, e inserendo fra le parentesi il tipo 
di destinazione. 

int 1 = 13; 

byte bl = i; //errore Cannot implicitly convert type 

'int' to 'byte' 
byte b2=(byte)i; //cast di int verso byte 

In alcuni casi l'operazione di cast può provo- 
care perdita di informazione, quindi è neces- 
sario sapere esattamente ciò che si vuole 
ottenere. Ad esempio convertendo un doublé 
in int per mezzo di un casting si avrebbe: 

doublé d = 1.432; 

int i = (int)d; 

Console. WriteLine(i); //stampa 1 

Si è persa così la precisione del tipo doublé. 
In altri casi l'operazione di cast, seppur pos- 
sibile a tempo di compilazione, potrebbe 
provocare un eccezione InvalidCastExcep- 
tion: 

object obj = "string"; 

int i = (int)obj; 

Il cast di object verso int è permesso dal com- 
pilatore, in quanto esso non può sapere a 
compile-time che tipo di dato è contenuto in 
un object. Durante l'esecuzione del program- 
ma però si verificherebbe un'eccezione, in 
quanto si tenterebbe di convertire una strin- 



ga in un numero intero. 
Un'altra possibilità, applicabile solo ai tipi ri- 
ferimento, è l'utilizzo dell'operatore as. 

Object obj = new TextBox(); 
Button btn = obj as Button; 

Il vantaggio nell' utilizzare l'operatore as in 
questo caso, è che esso restituirà nuli se la 
conversione non è possibile, senza lanciare 
eccezioni. 



I FACCIAMOLO 
IN VB.NET 

In visual basic.NET le conversioni sono rego- 
late per mezzo dell'istruzione Option Strict 
posta all'inizio di un file di codice. 
Se scrivete: 

Option Strict On 

allora si ha il controllo strict sui tipi e non sa- 
ranno possibili conversioni implicite fra tipi 
incompatibili. Ad esempio 

Dim i as Integer 
Dim d as Doublé 

d = 1.234 

i=d 

darà errore a compile-time in quanto non 
esiste una conversione implicita da doublé a 
integer. 

Lo stesso codice con V Option Strict Off con- 
vertirebbe correttamente il doublé in integer, 
naturalmente perdendo le cifre decimali, e 
restituendo 1. 

Nei casi in cui la conversione implicita non 
sia possibile è necessario ricorrere al casting 
esplicito, che si effettua per mezzo della fun- 
zione CType, che prende come primo argo- 
mento il dato da convertire e per secondo il 
tipo destinazione: 

i=CType(d, Integer) 

Se la conversione non è possibile, viene ge- 
nerata un'eccezione InvalidCastException. 
Esistono poi funzioni specializzate per un 
particolare tipo destinazione che prendono 
come parametro solo il dato da convertire, 



VISUAL BASIC 
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ad esempio CBool per convertire in boolean 
il parametro, CStr per la conversione in 
String e così via: 

dim boolVar as Boolean 
dim str as String 
boolVar=Cbool(i) 
str=CStr(i) 

Un'altra funzione utilizzabile per la conver- 
sione esplicita da e verso il tipo object è la 
DirectCast, che si usa in modo analogo alla 
CType. 

In questo caso però perché sia permessa una 
conversione fra due tipi, è richiesta una rela- 
zione di ereditarietà o implementazione fra 
di essi. 
Ad esempio: 



Dim q As Object = 9.456 



i = CType(q, Integer) ' ok 



Dim j As Integer = DirectCast(q, Integer) 'fallisce 

La CType va a buon fine come già visto, per- 
ché esiste una possibile conversione da 
Doublé a Integer, mentre la DirectCast fallisce 
generando una InvalidCastException. 

Dim f As New Form 

Dim e As Control 

e = DirectCast(f, Control) 'ok 

In questo secondo caso la DirectCast va a 
buon fine, dato che Form deriva da Control. 
Analoga alla DirectCast è la TryCast che però 
invece di generare una eventuale eccezione 
restituisce il valore Nothing. 



COME POSSO VISUALIZZARE L'ICONA 
ASSOCIATA AD UN FILE? 

UTILIZZEREMO IN MODO SEMPLICE ALCUNE DLL DI SISTEMA PER RAGGIUNGERE LO SCOPO, 
VEDREMO CHE È PIÙ FACILE DI QUELLO CHE NORMALMENTE SI PENSA 



VISUAL BASIC.NET 



1 Creiamo una nuova Windows application e 
nella form principale trasciniamo un combo- 
box, un componente PictureBox, un bottone 
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2 Utilizziamo lo smarttag associato al combobox 
per inserire le voci relative alle estensioni di cui 
vogliamo conoscere l'icona 




i Nella dialog box successiva aggiungiamo alcu- 
* ne estensioni che ci interessano, una per riga 



Enter the strlngs In the collection [one per Une): 



4 Agiamo con il tasto destro del mouse sul solu- 
tion explorer selezionando la form e dal menu 
contestuale scegliamo "view code" 
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5 Agendo ancora una volta sul solution explorer 
con il tasto destro del mouse, scegliamo questa 
volta "Add Reference" 
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i Dalla dialog box successiva scegliamo "System 
I .drawing" e infine clicchiamo su OK 
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7 Dichiariamo le funzioni di sistema che 
andremo ad utilizzare e le relative DLL 
che le contengono 

<DIIImport("shell32.dll")> 

Private Shared Function SHGetFileInfo(ByVal 

pszPath As String, _ 

ByVal dwFileAttributes As Integer, _ 

ByRef psfi As SHFILEINFO, _ 

ByVal cbFilelnfo As Integer, _ 

ByVal uFIags As Integer) As IntPtr 

End Function 

<DIIImport("User32.dll")> 

Private Shared Function DestroyIcon(ByVal hlcon 
As IntPtr) As Integer 
End Function 

<Structl_ayout(l_ayoutKind.Sequential)> _ 

Private Structure SHFILEINFO 

Public Const NAMESIZE As Integer = 80 

Public hlcon As IntPtr 

Public ilcon As Integer 

Public dwAttributes As Integer 

<MarshalAs(UnmanagedType.ByValTStr, 



SizeConst: = 260)> . 



Public szDisplayName As String 



<MarshalAs(UnmanagedType.ByValTStr / 

SizeConst:=80)> . 



Public szTypeName As String 



End Structure 

Aggiungiamo qualche costante che ci tor- 
nerà utile nel resto del procedimento 



8 



Private Const FILE_ATTRIBUTE_NORMAL = &H80 
Private Const FI LE_ATTRIBUTE_DI RECTO RY = &H10 
Private Const SHGFI_ICON = &H1Q0 

' get icon 

Private Const SHGFI_OPENICON = &H2 



get open icon 



Private Const SHGFIJJSEFILEATTRIBUTES : 
use passed dwFileAttribute 



&H10 



9 Infine scriviamo il codice relative alla funzione 
che estrarrà le icone utilizzando le dll di cui 
sopra 



Public Enum 


IcoTypeEnum 






File = FILE_ATTRIBUTE_ 


_NORMAL 




Directory 


= FILE_ATTRIBUTE_DIRECTORY 


End Enum 


Public Enum 


IcoSizeEnum 


grandezza 


icona 


Small = &H0 ' 16x16 


Large = &H1 ' 32x32 


End Enum 



Public Function GetFileIcon(ByVal ext As String, 
ByVal IcoSize As IcoSizeEnum) As Icon 
Dim hlmg As IntPtr 'handle all'image list di 

sistema. 

Dim shinfo As New SHFILEINFO 

Dim flags As Integer = 

SHGFIJJSEFILEATTRIBUTES Or SHGFI_ICON 

flags += IcoSize 

If Not ext.StartsWith(".") Then ext = "." & ext 

hlmg = SHGetFileInfo(ext, 

FILE_ATTRIBUTE_NORMAL, shinfo, _ 

Marshal.SizeOf(shinfo), 
flags) ' valorizza l'handle 
Dim mylcon As System. Drawing. Icon 
mylcon = System. Drawing. Icon. FromHandle( 
shinfo. hlcon). Clon 



DestroyIcon(shinfo. hlcon) 



Return mylcon 



End Function 

4| ^Torniamo in modalità disegno e ciccando 

I w due volte sul bottone otteniamo il template 

per l'evento OnClick, il relativo codice è il seguente 

Private Sub Buttonl_Click(ByVal sender As 
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System.Object, ByVal e As System. EventArgs) 
Handles Buttonl. Click 

Dim ico As Icon = GetFileIcon( 

ComboBoxl.SelectedItem.ToString(), 
IcoSizeEnum.Small) 
Dim bmp As System. Drawing.Bitmap = 

ico.ToBitmapO 
PictureBoxl.Image = bmp 
End SubO 

COME FUNZIONA? 

Il cuore del sistema è la funzione SHGetFilelnfo 
che è dichiarata nella DLL Shell32.dll. Per po- 
tere utilizzare questa funzione la ridichiariamo 
all'inizio del codice. 

La SHGetFilelnfo fa uso di alcune strutture 
come la SHFILEINFO che dichiariamo sempre 



all'interno del nostro codice. L'unica funzione 
che andiamo realmente a riscrivere secondo le 
nostre necessità è la GetFilelcon che riceve in 
input una stringa che rappresenta l'estensione 
e sfrutta la SHGetFilelnfo per ritornare un 
oggetto di tipo icon. Nell'evento OnClick del 
bottone non facciamo altro che passare i valori 
corretti alla GetFilelcon e mostrare tutto nella 
picturebox 



GLI IMPORT DA UTILIZZARE 

All'inizio del codice è necessario inserire le seguenti 
linee 

Imports System. Drawing 



Imports System. Drawing. Imaging 



Imports System. Runtime.InteropServices 



COME POSSO SAPERE SE UN NUMERO E PARI 
DISPARI? 



n; 



Iella rappresentazione binaria, tutti i 
numeri pari hanno il bit meno signi- 
ficativo (quello più a destra) pari a zero 
(0) mentre i numeri dispari pari ad 
uno(1) In VB.Net 2003 si può applicare 
l'operatore And ai valori numerici. In 



questo caso l'operatore And consente di 
eseguire un confronto bit per bit dei bit 
che occupano la stessa posizione in due 
espressioni numeriche diverse. Per i 
nostri scopi possiamo mettere in And il 
numero da testare, con il valore uno (1) 



Private Function NumeroDispari( 

ByVal NumeroDaTestare As Long) 
As Boolean 



NumeroDispari 



NumeroDaTestare 
And 1 



End Function 



QUALI SONO LE FUNZIONI PER MANIPOLARE 
STRINGHE IN VB.NET 2003? 



Chars - restituisce il caratte- 
re che corrisponde alla posi- 
zione passata come argo- 
mento. 

IndexOf - restituisce la posizio- 
ne della prima occorrenza di un 
carattere o stringa a partire dal- 
la posizione indicata. 
Last IndexOf - funziona in mo- 
do opposto al metodo IndexOf, 
restituisce l'indice dell'ultima 
occorrenza di un carattere o 
stringa. 

Substring - restituisce una 
sottostringa della stringa pas- 
sata come argomento, a partire 
da una posizione fino al numero 
di caratteri specificato. 
StartsWith - verifica se la 



stringa di test contiene come 
stringa iniziale quella indicata 
come parametro. Restituisce 
True o False. 

EndsWith - funziona in modo 
opposto controllando la stringa 
finale. Restituisce True o False. 
Insert - inserisce, all'interno 
della stringa esistente, una sot- 
tostringa a partire da un indice 
di posizione. 

Remove - elimina una sotto- 
stringa da una stringa esistente 
a partire da una posizione per 
uno specifico numero di carat- 
teri. 

Lenght - restituisce il numero 
di caratteri che compongono la 
stringa. 



Dim sTest As String = "IoProgrammo.it" 
MessageBox.Show(sTest.Chars(2)) 

'Visualizza P 
MessageBox.Show(sTest.IndexOf("m", 0)) 

'Visualizza 8 
MessageBox.Show(sTest.l_astIndexOf("m")) 

'Visualizza 9 
MessageBox.Show(sTest.Substring(2, 9)) 

'Visualizza Programmo 
MessageBox.Show(sTest.StartsWith("Io")) 

'Visualizza True 
MessageBox.Show(sTest.EndsWith(".it")) ' 

Visualizza True 
MessageBox.Show(sTest.Insert(0, "www.")) ' 
Visualizza www.IoProgrammo.it 
MessageBox.Show(sTest.Remove(ll, 3)) ' 

Visualizza IoProgrammo 
MessageBox.Show(sTest.Length) ' 

Visualizza 14 
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COME POSSO REALIZZARE 
APPLICAZIONI MULTILINGUE CON JAVA? 

POSSIAMO UTILIZZARE ALCUNE DELLE CARATTERISTICHE PECULIARI DEL LINGUAGGIO. 
VEDIAMO UN ESEMPIO CON ECLIPSE 



^■Apriamo eclipse 
1 Project 


e scegliamo 


File/New 
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(fra ShtfttJlliN ■ " PtWH* 
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I Dalla dialog box che segue scegliamo 
i "Java Project" 



f |fty* Frrtwàt Irom F.l-^u W Huilril^ 



I. tnr.pl. 



3 Diamo un nome significativo al progetto e 
lasciamo le altre opzioni come ci vengono 
proposte da eclipse 




4 Aggiungiamo una nuova classe al proget- 
to agendo con il tasto destro del mouse 
sul nome del progetto e scegliendo poi "New 
/Class" proposte da eclipse 
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5 Diamo un nome significativo alla classe e 
clicchiamo su finish. Facciamo generare 
automaticamente il main utilizzando l'appo- 
sito flag 



n 1 



1*. 4M -^ lt,t tHirJ f»:kkjl ,1 4ir £ .JlrJ»i 



2** ; 



» 4«<*4>r*4 m *t UDOU f ** «"« ir«i»(i' 



6 Aggiungiamo in testa al codice gli import 
che ci serviranno 

import java.text.MessageFormat; 

import java. util. Locale; 

import java. util. ResourceBundle; 
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[Modifichiamo il main come segue 



public static void main(String[] args) 
{ 
// TODO Auto-generated method stub 
if (args != nuli && args.length > 0) 
{ 
// Saluta in italiano ... 
Hello itHello = new Hello(Locale.ITALIAN); 
System. out.println(itHello.greet(args[0])); 



// ... e poi in inglese 

Hello enHello = new Hello(Locale.ENGLISH); 

System. out.println(enHello.greet(args[0])); 



else 
{ 

System. out.println("Usage java 

Hello [your name]"); 

System. exit(-l); 



8 



Aggiungiamo qualche variabile privata e 
creiamo il costruttore della classe 



private ResourceBundle bundle; 

private static final String FILE_PREFIX = 

"hello"; 

private static final String GREET_KEY = 

"greet"; 

public Hello(Locale locale) 

{ 

this. bundle = 

ResourceBundle. getBundle( 
Hello. FILE_PREFIX, locale); 



i Infine definiamo il metodo string_greet 



public String greet(String name) 

{ 
// estrae la stringa ... 

String msg = this. bundle. getString(GREET_KEY); 
StringBuffer msg_f = new String BufferQ; 



// ... e la formatta 

MessageFormat mf = new MessageFormat(msg); 
mf. format( new String[]{ name }, msg_f, nuli); 
return msg_f.toString(); 



M ^Aggiungiamo due file rispettivamente 

I w hello _en.properties y e hello Jt.properties, 

agendo con il pulsante destro sul nome del 



progetto e poi su New/File 
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M M I file in questione devono contenere la 
I definizione delle stringhe di linguaggio 
come segue: 



Edit Source Refactor Navigate Search Project Run Window 



;• | »■ O- <4- j & m @- J & 4' - *p o- # 




t¥, Package 

<gr class 

F4 

©■ Interface 

{$ Enum 
Shift+lnsert <g> Annot3tiorl 

Delete gj Source Fo | der 
Jj C5 Folder 



Shift+Alt+S 
Shift+Alt+T 



Untiti ed Text Rie 
jgfjUnit Test Case 



References 
Dedarations 

~ Refresh 
Close Project 



-\TU 



d maini St ring[ ] args) ■[ 



Debug As 

Team 

Compare With 

Restore from Locai History... 

PDE Tools 



pplication] /usr/lib/j2rel.5-sun/bin/j< 



(default package) - inter 



3»J&®©1)J&*® 



12 



Compiliamo il tutto e lanciamo l'appli- 
cazione con java 



Hello [Nome] 
ci verrà restituito il saluto in due lingue 

COME FUNZIONA? 

Tutto sta nel richiedere il giusto file di interna- 
zionalizzazione, la stringa viene estratta dal 
metodo String_Greet che restituisce la corretta 
localizzazione. 
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COME POSSO AVERE INFORMAZIONI 
SULLE CLASSI CARICATE? 

UN ESEMPIO PRATICO PER IMPARARE COME VENGONO RICHIAMATE LE CLASSI ALL'INTERNO 
DI JAVA E COME VIENE GESTITA LA MEMORIA 



In questo tip illustreremo come tracciare l'at- 
tività di due componenti di primaria impor- 
tanza all'interno della Java Virtual Machine: 
ClassLoader e Garbage Collector. Il primo è 
responsabile del caricamento delle classi 
richiamate durante il ciclo di vita dell'appli- 
cazione, mentre il secondo si prende cura di 
liberare, in maniera trasparente agli occhi 
dello sviluppatore, gli oggetti non referenzia- 
ti all'interno della heap memory. Per capire 
meglio tali attività useremo un'applicazione 
di esempio che stampa un valore doublé 
casuale compreso tra 0.0 e 1.0. Nel metodo 
main è stata introdotta una chiamata esplici- 
ta al metodo System.gcO in modo da simula- 
re un'esecuzione del Garbage Collector. 

/** 

* Classe di esempio per la stampa di un numero 

* (doublé) casuale 



*/ 



public class RandomPrinter { 



Stampa un numero random a video 



*/ 



public void printQ { 



System. out.println("Random: " + 

Math.randomQ); 



Entry point dell'applicazione 



*/ 



public static void main(String[] agrs) { 



System. out.println("START"); 



RandomPrinter rp = new RandomPrinterQ; 



rp. printQ; 



System.gcO; 



System. out.println("END"); 



> 



Eseguendo la nostra applicazione di esempio 
con il comando "java" e l'opzione - 
verbose: class, avremo un output molto simi- 
le al seguente (la formattazione potrebbe 
dipendere dall'implementazione della JVM): 



>java -verbose: class RandomPrinter 
[Opened /usr/java/jdkl.5.0_01/jre/lib/rt.jar] 
[Opened /usr/java/jdkl.5.0_01/jre/lib/jsse.jar] 
[Opened /usr/java/jdkl.5.0_01/jre/lib/jce.jar] 
[Opened 

/usr/java/jdkl.5.0_01/jre/lib/charsets.jar] 



[Loaded java.lang.Object from shared objects 



file] 



[Loaded java.io.Serializable from shared objects 
file] 

.... seguono altri 330 caricamenti 

[Loaded java.util.regex.Pattern$TreeInfo from 

shared objects file] 

Random: 0.6229570234648002 

[Loaded java.lang.Enum from shared objects file] 

END 

[Loaded java.lang.Shutdown from shared objects 

file] 

[Loaded java.lang.Shutdown$Lock from shared 

objects file] 

Nonostante la palese semplicità della classe 
monitorata, il ClassLoader carica oltre 300 
classi, la cui origine risiede nei quattro jar 
files aperti all'inizio dell'esecuzione. 
Se nel comando eseguito precedentemente si 
cambia l'opzione class con gc vengono inve- 
ce tracciate le esecuzioni del Garbage 
Collector: 

>java -verbose: gc RandomPrinter 

START 

Random: 0.9247276620083805 

[Full GC 196K->103K(1984K), 0.0228140 secs] 
END 



• Full GC: indica che il processo del GC ha 
attraversato l'intera heap memory. 

Il significato delle stampe del GC è abbastan- 
za semplice: 

• 196K: era la dimensione della heap prima 
dell'esecuzione del GC. 

• 103K: è la dimensione della heap dopo 
dell'esecuzione del GC. 

• 1984K: è la memoria disponibile (memoria 
totale - memoria occupata dagli oggetti 

"vivi"). 

• 0.0228140 secs: è il tempo impiegato 
dal GC. 
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Visual Basic 6 e SQL Server Express 



SQL SERVER EXPRESS 2005 
E LE STORED PROCEDURE 

DESCRIVEREMO COME REALIZZARE UN'APPLICAZIONE CLIENT-SERVER MULTIMEDIALE CHE UTILIZZA 
MODULI DI CLASSE, STORED PROCEDURE E UN DATABASE MICROSOFT SQL SERVER EXPRESS. 
OVVIAMENTE LO FAREMO UTILIZZANDO VISUAL BASIC 6.0 




Ci CD □ WEB 

VBSQLExpress.zip 




el precedente appuntamento abbiamo pre- 
sentato Microsoft SQL Server 2005 Express 
Edition ed alcuni elementi ad esso collega- 
ti come SQL Server Management Studio Express - un 
free database Manager - e SQL Native Clientìa. nuova 
tecnologia per l'accesso ai dati. Come esempio ab- 
biamo introdotto un'applicazione Client/Server che ge- 
stisce una mediateca, cioè un archivio con una serie 
di informazioni sui dati contenuti in dei supporti mul- 
timediali {DVD, CD ecc.). Il database dell'applicazio- 
ne, nominato DVD, tra l'altro, include la tabella Sup- 
porto con i dati principali dei supporti ottici. Nell'e- 
sempio l'interazione tra l'applicazione e il database è 
gestita tramite delle Query SQL invocati da oggetti 
ADODB. In questo appuntamento continuiamo la 
trattazione su SQL Express e presentiamo altre mo- 
dalità d'interazione con i database quali Stored Pro- 
cedure, T-SQL Debugger e Tool Data View. Per quan- 
to riguarda l'applicazione d'esempio continueremo 
con la gestione della mediateca, introducendo nuove 
tabelle e nuove funzionalità. In realtà, manteniamo l'i- 
dea fondamentale, cioè quella di archiviare i dati dei 
supporti ottici, ma modifichiamo sia gli elementi del 
database che quelli dell'interfaccia e presentiamo 
una tecnica d'interazione tra Visual Basic e DBMS 
basata sui moduli di classe e Stored Procedure. 



As Istruzioni_Transact-SQL [ ...n ] 

I parametri possono essere di Input di Output o di 
InputOutput. Ad ogni parametro è associato un tipo 
{Datatypé) e un valore (opzionale) di Default II nome 
del parametro è preceduto dal carattere @. Le istru- 
zioni della SP, sono specificate dopo l'elenco dei pa- 
rametri. Come vedremo negli esempi le SP sono in- 
vocate utilizzando gli oggetti ADODB. In particolare 
sono utilizzati alcuni elementi dell'ADO Connection. 
Per specificare la SP, da eseguire, si utilizza la pro- 
prietà CommandText, la CommandType, invece è uti- 
lizzata per indicare il tipo di Command che deve es- 
sere utilizzato (cioè Command di tipo Stored Procedure). 
Negli esempi utilizzeremo anche i metodi: Create- 
Parameter ed Execute. Il primo crea un nuovo para- 
metro con un Nome (valore opzionale), un tipo, una 
direzione (per esempio adParamlnput oppure ad- 
ParamOutput), una dimensione (dipende dal tipo) e 
un valore. Il metodo Execute, invece, avvia l'esecu- 
zione della Stored Procedure. Ricordiamo che un Com- 
mand è un oggetto che può essere usato per esegui- 
re una query o appunto una Stored Procedure e che 
l'oggetto Parameters rappresenta l'insieme dei para- 
metri (insieme di oggetti Parametef) dell'oggetto 
Command. 



n 




■ imi imi imi ^m 

3 Conoscenze su Moduli 

' di Classe, 

oggetto MsHFlexGrìd, 
oggetti ADO, SQL. 

Piattaforma Windows 
2000 o superiore. 
Visual Basic 6 SP6, 
Microsoft dotNET 
Framework v2.0, SQL 
Server Express 2005. 






ADO E STORED 
PROCEDURE 

Le Stored Procedure (SP) sono degli script collocati 
nel DBMS. Esse sono composte da istruzioni SQL e 
istruzioni per il controllo di flusso. Una SP è identifi- 
cata attraverso un nome ed è elaborata come una 
singola unità. Ai fini della programmazione una SP 
può essere vista come un metodo, infatti può riceve- 
re e restituire parametri. Le SP sono compilate solo 
alla prima esecuzione. La sintassi, non completa per 
la creazione di una Stored Procedure è la seguente. 

Create Procedure NomeProcedura 
( @nomeparametroIn datatypé [= valore di default], 
@nomeparametroInOut datatypé [= valore di default] 

OUTPUT ) 



CREARE ED ESEGUIRE 
URIA SEMPLICE STORED 
PROCEDURE 

Descriviamo come creare, eseguire e controllare la 
Stored Procedure che restituisce il valore massimo 
contenuto nel campo SupportoID della tabella Sup- 
porto (descritta nella Tabella 1) . 

ICon SQL Server Management Studio create il da- 
tabase DVD con almeno la tabella Supporto. Se 
non avete voglia di scrivere i nomi delle tabelle e dei 
relativi campi, per creare il database, potete utilizza- 
re lo script inserito nel CD allegato alla rivista. Dopo 
aver creato la tabella cliccateci sopra, con il tasto de- 
stro del Mouse, e quindi selezionate la voce di menu 
nuova Query SQL. Sulla finestra che compare inse- 
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Supporto 


Campo 


Tipo 


supportoID 


int IDENTITY(U) NOTNULL 


Descrizione 


Nvarchar (250) NULL 


Tipo 


Nvarchar (50) NULL 


Durata 


Nvarchar (50) NULL 


Critica 


ntext NULL 


Data 


Datetime NULL 


Trailer 


Nvarchar (250) NULL 


Masterizzato 


Nvarchar (2) NULL 


Copertinaimm 


Image NULL 


Posizione 


Nvarchar (250) NULL 


Lingua 


Nvarchar (50) NULL 






Una Tabella Complementare 


Campo 


Tipo 


supportoID 


int NOTNULL 


AttorelD 


int NOTNULL 


DesAttore 


Nvarchar (250) NOT NULL 



Tabella h Le tabelle Supporto ed Attore 



rite il seguente codice e cliccate Execute. 

Create PROCEDURE 

[dbo].[SP_Select_Max_Supporto] 
(@supportoID [int] output) 

AS 

BEGIN 

SELECT @supportoID = Max(supportoID) from 

Supporto 

END 



Dim connectionADO As ADODB. Connection 
Public Function Collegati() As ADODB.Connection 
Set connectionADO = New ADODB.Connection 
With connectionADO 

.ConnectionTimeout = 30 

.CommandTimeout = 100 

.Open "DSNdvd", "sa", "" 
End With 




Set Collegati = connectionADO 



End Function 



Public Sub ScollegatiQ 



connectionADO. Close 



Set connectionADO = Nothing 



End Sub 



RELAZIONI TRA TABELLE 






Le informazioni contenute nelle 
tabelle di un database sono 
ricollegate attraverso le relazioni 
che sono delle associazioni tra 
campi comuni delle tabelle. I 
campi comuni sono: la chiave 
primaria {Primary Key) e la chiave 
esterna {Foreign Key - un campo 
con lo stesso nome della Primary 
Key) di un'altra tabella. Quest'ul- 
tima assicura l' integrità refe- 
renziale tra i dati delle tabelle. Le 



Relazioni possono essere: 

• uno-a-uno (cioè ad ogni record 
in una tabella può corrispondere 
un solo record nell'altra); 

• uno-a-molti (ad ogni elemento 
della prima tabella possono 
corrispondere n elementi 
dell'altra) 

• molti-a-molti (un elemento di 
una tabella può avere molti ele- 
menti corrispondenti nell'altra 
tabella e viceversa). 



I Infine bisogna inserire il seguente codice in 
) un pulsante. 



La SP_Select_Mox_Supporto. La SP non fa altro che 
eseguire una query che seleziona il massimo valore 
contenuto nel campo supportold della tabella Sup- 
porto. 

2 Per Invocare la SP_Select_Max_Supporto, in un 
progetto Visual Basic, bisogna referenziare la li- 
breria ADODB - Microsoft Activex Data Object 2.6 Li- 
brary -, collegarsi al database con un DSN {Data Sour- 
ce Nome. Il DSN va. nominato DSNdvd. Le procedu- 
re che permettono di collegarsi e scollegarsi al data- 
base sono le seguenti: 
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F/gf. 1; Le Stoted Procedure del DataBase DVD 



Private Sub Commandl_Click() 



Dim SpCom As ADODB.Command 



Dim pari As ADODB.Parameter 



Dim strSql As String 



On Error GoTo errore 



SetSpCom = New ADODB.Command 



strSql = "SP_Select_Max_Supporto" 



Set pari = SpCom.CreateParameter 

("MaxsupportoID", adlnteger, adParamOutput, 4) 



SpCom.Parameters.Append pari 



SpCom.CommandText = strSql 



SpCom.CommandType = adCmdStoredProc 



SpCom.ActiveConnection = Collegati 



SpCom. Execute 



MsgBox "Il valore Massimo è: " + CStr(SpCom. 

Parameters("MaxsupportoID").Value) 



Set SpCom = Nothing 



Scollegati 



Exit Sub 



errore: 



MsgBox Err.Description 



End Sub 

La procedura precedente invoca la SP_Select_ Mox_Sup- 
porto e mostra il valore massimo, restituito dalla SP, 
in un MsgBox. 
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SQL SERVER 

EXPRESS 

ETOOLS 

Collegandovi al link 

http://go. m icrosoft.com 

/fwlink/?Linkld=31401 

potete scaricare SQL 

Server Express e SQL 

Server Management 

Studio Express. 

Ricordiamo che SQL 

Express può essere 

installato se è presente 

almeno Windows 2000 

e la versione 2.0 di 

dotNET Framework. 

Con SQL Express è 

installata, anche, SQL 

Native Client: la nuova 

tecnologia di accesso 

ai dati. Ricordiamo, 

però che si può 

accedere ai database 

SQL Express anche con 

il Driver SQL Server 

classico. Per 

approfondire le 

conoscenze su SQL 

Server 2005 vi 

consigliamo di 

scaricare SOL Server 

Books Online. 



L'APPLICAZIONE 
GESTIONE MEDIATECA 

Nel precedente appuntamento abbiamo presentato 
un prototipo di applicazione per gestire un archivio 
con le informazioni sul contenuto di supporti multi- 
mediali (DVD, CD ecc.). Tra le informazioni trattate 
abbiamo incluso anche l'immagine della copertina 
(cover) del supporto, che abbiamo salvato in un cam- 
po di tipo image della tabella Supporto. In questo ap- 
puntamento modifichiamo radicalmente al tabella 
Supporto ed introduciamo altre tabelle complemen- 
tari, collegati con relazione uno-a-molti alla Suppor- 
to. Queste tabelle includono soltanto delle descrizio- 
ni (qualcuno potrebbe dire che basterebbe una solo 
tabella con tanti campi descrizione e un tipo!?). Per 
esempio se il contenuto di un supporto multimedia- 
le è un film, le tabelle complementari potrebbero con- 
tenere l'elenco degli attori, dei registi ecc. Mentre se 
si tratta di Softwarele tabelle complementari potreb- 
bero contenere informazioni sugli Autori dei pro- 
grammi, sul tipo di licenza, sulla versione ecc. Tra le 
nuove features dell'applicazione inseriamo la gestio- 
ne di informazioni multimediali contenuti in dei file com- 
patibili con Media Player. Per archiviare questi file 
Multimediali (che potrebbero essere anche interi film) 
ci serviremo di una directory di Windows, collocabile 
nell'Hard Disk o nel supporto ottico. Nella Tabella 1 
sono riportate la nuova tabella Supporto e una tabel- 
la complementare. Nei paragrafi successivi descrive- 
remo tre pezzi di applicazione. 

1) La Form che gestisce i dati principali dei Suppor- 
ti Ottici. 

2) Il Modulo di Classe - ClsSupporto - che fa da in- 
termediario tra la Form e la tabella Supporto. 

3) La SP_Insert_Supporto - una delle Stored Proce- 
dure associate alla tabella Supporto. 



LA FORM SUPPORTO 

La Form che gestisce i dati principali dei supporti ot- 
tici è nominata FrmSupporto. Essa interagisce con i 
dati attraverso gli elementi pubblici della classe Cls- 
Supporto. La FrmSupporto è divisa in tre parti: Ricer- 
ca; gestione elementi tabella Supporto e gestione dati ta- 
belle Complementari [Attori, Genere ecc.). Nella parte 
superiore, dedicata alla ricerca, è presente una MSH- 
FlexGrid collegata ad un RecordSet Gerarchico realiz- 
zato con una maschera DataEnvironment. La parte 
centrale, dedicata agli elementi della tabella Suppor- 
to, contiene gli oggetti grafici, indirettamente, colle- 
gati ai campi della tabella Supporto. In particolare i 
campi: SupportoID, Descrizione, Posizione, Durata so- 
no associati a degli oggetti textbox; Tipo e Lingua so- 
no associati a dei ComboBox; Masterizzato è associa- 
to a due Option Button (Si e No). Il campo Immagine 
copertina, invece, è associato ad una PictureBox ed a 




T«* 



1 *** 
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Fig. 2: La FrmSupporto in fase di progettazione 

un Command Button. Quest'ultimo insieme ad un 
controllo Common Dialogarmene di selezionare il fi- 
le immagine da salvare nel database. Infine per gesti- 
re il file multimediale - il cui Path è salvato nel campo 
Trailer - sono previsti un TextBox e un Command But- 
ton. Quest'ultimo invoca un' altra form (nominata 
frmDVD) che riproduce il file con un oggetto Media 
Player. I dati di questi oggetti possono essere recupe- 
rati od inseriti nel Database, grazie ai pulsanti: Nuo- 
vo, Salva, Cancella e Ricerca. In realtà, come capire- 
mo più avanti, il pulsante Ricerca è superfluo dato che 
gli elementi del database sono selezionati direttamente 
sulla MSHFlexGrid. La parte inferiore della Finestra, 
invece, permette di associare al Supporto corrente i 
valori delle Tabelle Complementari, queste funziona- 
lità, però, al momento sono gestite solo in visualizza- 
zione (se nelle tabelle Complementari sono presenti dei 
valori saranno mostrati nei ComboBox relativi). Del 
codice della FrmSupporto introduciamo soltanto quel- 
lo strettamente legato al modulo di Classe ClsSupporto 
e alla. SP_Insert_Supporto. Iniziamo a descrivere il co- 
dice partendo dalla parte dichiarativa che deve inclu- 
dere la definizione di un oggetto del tipo ClsSupporto 
e la costante che individua la Directory che contiene i 
file multimediali dei Trailer. 

Dim BufSupporto As ClsSupporto 
Const DirTrailer = "C:\Trailer\" 

La FormJLoad invece contiene il codice che carica i 
ComboBox: Lingua e Tipo Supporto 

Private Sub Form_l_oad() 
CaricaCombo 
End Sub 

Quando si deve inserire un nuovo Supporto nell'ar- 
chivio, sulla maschera bisogna innanzitutto cliccare 
il pulsante Nuovo, poi, specificare i valori per i vari ele- 
menti dell'interfaccia ed infine cliccare il pulsante Sal- 
va. Il codice per i pulsanti Nuovo e Salva è il seguente. 
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Private Sub Nuovo_Click() 



Set BufSupporto = New ClsSupporto 



txtsupportoID.Enabled = False 



SvuotaText 



'svuota gli elementi dell'interfaccia 



txtdescrizione.SetFocus 



End Sub 



Private Sub Salva_Click() 



'inserire controllo errori 



ValorizzaBuffer 



BufSupporto. salvaSP 



ValorizzaCampiForm 



'aggiorna gli elementi dell'interfaccia 



Set BufSupporto = Nothing 



SvuotaText 



Exit Sub 



End Sub 

La ValorizzaBuffer, invocata dalla Salva_Click, valo- 
rizza l'oggetto BufSupporto con i valori specificati ne- 
gli elementi dell'interfaccia. Facciamo notare che nel- 
la ValorizzaBuffer, presentata sotto, non è presente 
l'attributo di classe associato all'immagine della co- 
pertina, questo perché la copertina è passata alla clas- 
se utilizzando il file immagine temporaneo C:\temp.jpg 
come vedremo nel codice della classe. 

Private Sub ValorizzaBuffer() 
With BufSupporto 

.descrizione = txtdescrizione 

.tipo = ComboTipo.Text 

.Trailer = txttrailer 

.data = txtdata 

.critica = txtcritica 

.durata = txtdurata 

If Optionl Then 

.masterizzato = "SI" 

Else 

.masterizzato = "NO" 

End If 

.lingua = ComboLingua.Text 

.descrizionepos = txtposdescrizione 

End With 

End Sub 



La Cancella ClickQ e la Ricerca ClickO sono le seguenti. 



Private Sub Cancella_Click() 
On Error GoTo errore 
BufSupporto. Cancella 
Set BufSupporto = Nothing 
SvuotaText 

Exit Sub 

errore: 

MsgBox Err.Description 



End Sub 



Private Sub Ricerca_Click() 



Set BufSupporto = New ClsSupporto 



SvuotaText 



BufSupporto. Ricerca 



If BufSupporto. DaDB Then 



ValorizzaCampiForm 



Else 



MsgBox "Record non trovato", . 




vbOKOnly + vbCritical, "Attenzione" 



End If 



End Sub 
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Fig. 3: La FrmSupporto in fase di esecuzione 

L'attributo DaDB, della classe ClsSupporto, utilizzato 
nella Ricercagliele, permette di stabilire se i dati pre- 
senti sulla maschera sono nuovi o letti dal database. In- 
fine il codice che esegue il file multimediale sulla Frm- 
Trailer è il seguente. 

Private Sub Trailer_Click() 
FrmTrailer.avviatrailer DirTrailer + txttrailer 
End Sub 

La FrmTrailer e il resto del codice lo trovate nel CD al- 
legato alla rivista. 



TOOL DATA VIEW E T-SQL DEBUGGER 



'inserire controlli errori 



Neil 'IDE di Visual Basic per gestire e 
controllare una Stored Procedure ab- 
biamo a disposizione due strumenti: 
il Data Viewe il T-SQL Debugger. Il 
Data View, permette di connettersi 
al database e manipolare i suoi ele- 
menti. Il T-SQL Debugger permette 
di eseguire il Debug delle Stored 
Procedure. Il Data View sì attiva clic- 
cando l'icona (che rappresenta un ci- 
lindro di colore giallo) presente sulla 
toolbar dell' ID. Sulla finestra Data 
View, bisogna selezionare l'icona 
Data Link per creare un collegamen- 



to ad un database. Il collegamento 
può essere fatto attraverso VODBC 
oppure direttamente attraverso 
OLEDB. Per attivare il T-SQL Debug- 
ger, invece, basta selezionare, sulla 
finestra del Data View, una Stored 
Procedure e cliccare, con il tasto de- 
stro del Mouse, la voce di menu De- 
bug. Il T-Sql Debugger permette: di 
vedere lo stack delle chiamate verso 
SQL Server, i valori delle variabili lo- 
cali e globali e di controllare il flusso 
di programma nella Stored 
Procedure. 
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AMMINISTRAZIONE 
ODBC E DSN 

L'Amministratore Origini 
dati ODBC permette di 
creare i DSN (Data Sour- 
ce Name). Ad esso si ac- 
cede attraverso il menu 
strumenti di amministra- 
zione del sistema Ope- 
rativo o dal Pannello di 
controllo. Le connessioni 
alle fonti dati (per esem- 
pio Access o SQL Server) 
possono essere fatte se 
si è in possesso dei dri- 
ver necessari (si controlli 
la scheda DSN utente 
dell'amministratore). 
Nel caso di SQL Express 
deve esserci il Driver SQL 
Native Client. Per creare 
un DSN basta seguire gli 
Step del Wizard Aggiun- 
gi DSN Utente questo 
permette di scegliere il 
Driver, il tipo e il nome 
del database. Per i nostri 
esempi abbiamo creato 
il DSN Utente nominato 
DSNdvd connesso al file 
C:\data\ dvd.mdf . 



LA TECNICA 

DI RICERCA USATA 

NELLA FRMSUPPORTO 

In questo esempio spieghiamo come visualizzare, 
con un oggetto MSHFlexGrid, i dati della gerarchia 
Supporto, Attori e Generi e come selezionare l'i- 
dentificatore di un riga della griglia. Questa tecni- 
ca è usata per eseguire la ricerca sulla FrmSup- 
porto. 

1 Create un nuovo progetto Visual Basic ed in es- 
so inserite una finestra di progettazione Data 
Environment ed un riferimento al componente 
MSChart Control 6.0 (MSCHRT20.OCX). 



■*ldfll 
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- % ConDVD 
- Ufi] supporto 
^ supp 
[|] desc- 
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[^ durata 
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|_| trailer 
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:■■ 

|_| posizione 
|_| lingua 

- IH attore 

[f] supr 
d] attoreid 
[f] des; 

- HO] genere 

[f] supr 
[f] gerì' 
[f] des; 



... 



[4] oggetto/i 



Fig. 4: La Finestra Data Environment in cui è creata 
la gerarchia 

2 Attraverso un DSN (per esempio DSNdvd) col- 
legate la finestra Data Environment al databa- 
se DVD (che contiene le tabelle Supporto, Genere ed 
Attore) . Con il Data Environment create una strut- 
tura gerarchica con tre Command: Supporto, Atto- 
re e Genere. Dove Supporto è il Parent delle altre 
due tabelle. 

3 Sulla Formi inserite un oggetto MsHFlexGrid. Que- 
sto va collegato al Data Environment con il se- 
guente codice. 

Private Sub Form_l_oad() 
With MSHFlexGrid 1 

Set .DataSource = DataEnvironmentl 

.BandExpandable(O) = True 

.BandExpandable(l) = True 

.BandExpandable(2) = True 

.ColHeader(l) = flexColHeaderOn 

.ColHeader(2) = flexColHeaderOn 

.BandDisplay = flexBandDisplayVertical 

End With 

End Sub 



Le istruzioni precedenti, dopo aver associato la ge- 
rarchia del DataEnvironmentl alla MSHFlexGridl 



impostano le proprietà che permettono di espan- 
dere i dati in verticale. 

4 Ora introduciamo le istruzioni che permetto- 
no di ricavare il valore del codice associato al 
record della tabella Parent della gerarchia (nel no- 
stro caso il valore di SupportoID della tabella Sup- 
porto) . A tal fine inseriamo le istruzioni nella MSH- 
FlexGridl _Click(). 



Private Sub MSHFlexGrid l_Click() 


Dim com As Integer 


On Error Resumé Next 


com = MSHFlexGridl. RowSel 


While MSHFIexGridl.TextMatrix(com 


1) 


<> 

"supportoID" 


com = com - 1 


Wend 


MsgBox MSHFlexGrid l.TextMatrix(com 


+ 1, 


1) 


End Sub 



LA TECNICA DI RICERCA 
USATA NELLA 
FRMSUPPORTO 

Come accennato la FrmSupporto è correlata al mo- 
dulo di Classe ClsSupporto che a sua volta è definita 
in base ai campi delle tabella Supporto. In parti- 
colare gli attributi della classe sono i seguenti: 

Private mvarsupportoID As Long 
Private mvardescrizione As String 
Private mvartipo As String 



Private mvardurata As String 



Private mvarcritica As String 



Private mvartrailer As String 



Private mvardata As Date 



Private mvarMasterizzato As String 



Private mvardescrizionepos As String 



Private mvarlingua As String 

Nella classe definiamo anche l'attributo DaDB e 
la variabile globale connectionADO. DaDB serve a 
stabilire quale SP (la Inserto Ir UpData) eseguire nel 
metodo SalvaSP. 

Private mvarDaDB As Boolean 

Private connectionADO As ADODB. Connection 

Di seguito riportiamo la definizione delle proprietà 
Lete Get dell'attributo DaDB. 

Public Property Let DaDB(ByVal vData As Boolean) 
mvarDaDB = vData 



End Property 



Public Property Get DaDB() As Boolean 

DaDB = mvarDaDB 

End Property 
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Fig. 5: La Finestra Creazione Guidata Modulo di 
Classe 

Ricordiamo che i moduli di classi possono essere 
creati utilizzando l'aggiunta Creazione guidata 
Classe, mostrata in figura 5. La ClsSupporto pre- 
senta diversi metodi, di seguito riportiamo il Sal- 
vaSP e il CaricaCombo. Il SalvaSP, in base al para- 
metro DaDB, permette di fare un inserimento o 
un aggiornamento sul database. CaricaCombo, in- 
vece, permette di caricare un ComboBox con i da- 
ti di una tabella complementare. 

Public Sub salvaSP() 

Dim SpCom As ADODB.Command 

Dim pari As ADODB.Parameter 

Dim strSql As String 

Set SpCom = New ADODB.Command 

If DaDB = True Then 

strSql = "SP_update_Sup porto" 

Set pari = SpCom. CreateParameter("supportoID", 

adlnteger, adParamlnput, 4, supportoID) 



SpCom. Parameters.Append pari 



Else 



strSql = "SP_insert_Supporto" 



Set pari = SpCom. CreateParameter("supportoID", 

adlnteger, adParamlnputOutput, 4, supportoID) 



SpCom. Parameters.Append pari 



End If 



SpCom. CommandText = strSql 



SpCom. CommandType = adCmdStoredProc 

Set pari = SpCom. CreateParameter("descrizione", 

adVarChar, adParamlnput, 250, descrizione) 
SpCom. Parameters.Append pari 
Set pari = SpCom. CreateParameter("tipo", adVarChar, 

adParamlnput, 50, tipo) 



SpCom. Parameters.Append pari 



Set pari = SpCom. CreateParameter("durata", adVarChar, 
adParamlnput, 50, durata) 



SpCom. Parameters.Append pari 



Set pari = SpCom. CreateParameter("critica", adChar, 

adParamlnput, 1024, critica) 



SpCom. Parameters.Append pari 



Set pari = SpCom. CreateParameter("trailer", adVarChar, 
adParamlnput, 255, trailer) 



SpCom. Parameters.Append pari 



Set pari = SpCom. CreateParameter("data", 



adDBTimeStamp, adParamlnput, 14, data) 



SpCom. Parameters.Append pari 



Set pari = SpCom. CreateParameter("masterizzato", 

adChar, adParamlnput, 2, masterizzato) 



SpCom. Parameters.Append pari 



Dim stado As New ADODB.Stream 



'oggetto introdotto nel precedente articolo 



stado.Type = adTypeBinary 




stado. Open 



stado. LoadFromFile "c:\temp.jpg" 



Set pari = SpCom. CreateParameter("copertinaimm", 

adLongVarBinary, adParamlnput, stado. Size, 

stado. Read) 



SpCom. Parameters.Append pari 



stado. Close 



Kill ("c:\temp.jpg") 



Set pari = SpCom. CreateParameter("posizione", 

adVarChar, adParamlnput, 250, Me.descrizionepos) 



SpCom. Parameters.Append pari 



Set pari = SpCom. CreateParameter("lingua", adVarChar, 
adParamlnput, 50, lingua) 



SpCom. Parameters.Append pari 



SpCom. ActiveConnection = Collegati 



SpCom. Execute 



If DaDB = False Then 



'nuovo record 



Me. supportoID 
DaDB = True 



■ SpCom. Parameters("supportoID").Value 



End If 



Set SpCom = Nothing 



Scollegati 



Exit Sub 



errore: 



MsgBox Err.Description 



End Sub 



Public Sub CaricaCombo(combo As ComboBox) 
Dim RecordsQuery As New ADODB.Recordset 



Dim cSQL As String 



combo.Clear 



Select Case combo.Name 



Case "ComboAttori" 



cSQL = "select * from attore" 



IL MODELLO THREE-TIER 



Il Three-Tierè un modello di svilup- 
po per applicazioni Client/Server. Es- 
so stabilisce che gli elementi di 
un'applicazione devono essere di- 
stribuiti su tre livelli o strati: User 
Tier, Business Tier, Data Tier. In ogni 
strato gli elementi devono svolgere 
una determinata funzione e scam- 
biare, se necessario, dati e risultati 
con gli altri elementi dello stesso 
strato e con quelli dello strato in- 
feriore o superiore. Ogni livello può 
essere costituito da uno o più com- 
ponenti residenti sullo stesso com- 



puter o distribuiti su computer di- 
versi. L'User Tier è lo strato respon- 
sabile dell'interfaccia utente. Il Bu- 
siness Tier. contiene gli elementi 
che implementano il cuore dell'ap- 
plicazione, cioè le regole con le qua- 
li devono essere elaborate le infor- 
mazioni presenti sul database prima 
di essere mostrati attraverso lo stra- 
to di presentazione. Il Data Tier é lo 
strato responsabile dell'accesso e 
del mantenimento dei dati persi- 
stenti dell'Applicazione, esso si 
estende fino al DBMS. 
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& " where supportoID = " & CStr(supportoID) 
Case "ComboGenere" 

cSQL = "select * from genere" _ 
& " where supportoID = " & CStr(supportoID) 
End Select 

RecordsQuery.Open cSQL, Collegati, adOpenKeyset, _ 
adLockOptimistic '"" adOpenForwardOnly 
While Not RecordsQuery.EOF 
combo.Addltem CStr(RecordsQuery.Fields(l)) _ 
& " - " + RecordsQuery.Fields(2) 
RecordsQuery. MoveNext 

Wend 

If combo.ListCount <> Then 
combo.Listlndex = 

End If 

End Sub 

Sul CD allegato alla rivista, trovate la classe completa 
e il metodo Salva implementato senza SP. 
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Fig. 6: Come avviare il Debug di una Stored 
Procedure dal Visualizzatore Dati 



UNA SP DELLA TABELLA 
SUPPORTO 

In genere una SP è associata ad una singola azione 
che è possibile fare su una tabella, per esempio si 
definisce la SP_Insert per inserire un record, la 
SPJJpdate per modificarlo e la SP_Cancella per 
cancellarlo. Nel caso della tabella Supporto defi- 
niamo: SP_insert_Supporto } SP_Update_Suppor- 
to e SP_Delete_Supporto. Le Stored Procedure le 
possiamo implementare manualmente come illu- 
strato in precedenza oppure utilizzando il Wizard 
- Create Stored Procedure - presente in SQLServer, 
ma non in SQL Express. In quest'ultimo infatti so- 
no presenti soltanto dei Template di SP. Di segui- 
to presentiamo la SP_insert_Supporto. Dato che la 
Tabella Supporto ha 11 campi, la SP presenta 11 
parametri di cui uno {SupportoID) di solo output. 

CREATE PROCEDURE [SP_insert_Supporto] 

(@supportoID [int] output, 



©descrizione [nvarchar](250), 



@tipo [nvarchar](50) , 



©durata [nvarchar](50) , 



©critica [ntext] , 



©trailer [nvarchar](255), 



©data [datetime] , 



©masterizzato [nvarchar](2) , 



©copertinaimm [image] , 



©posizione [nvarchar](250), 



©lingua [nvarchar](50)) 



Begin 



INSERT INTO [supporto] 



( [descrizione] 



,[tipo] 



, [durata] 



, [critica] 



, [trailer] 



,[data] 



, [masterizzato] 



, [copertinaimm] 



, [posizione] 



, [lingua] 



) 



VALUES 



(©descrizione, 



©tipo, 



©durata, 



©critica, 



©trailer, 



©data, 



©masterizzato, 



©copertinaimm, 



©posizione, 



©lingua 



) 



SELECT ©supportoID = ©©IDENTITY 



end 



Nella SP prima è lanciata una query di Insert e poi 
è ricavato il valore di supportoID (che ricordiamo 
è un campo che crea una sequenza numerica per 
identificare i nuovi record). L'identificatore del re- 
cord è restituito da @@IDENTITY } questo è impo- 
stato nel parametro di Output @supportoID. No- 
tate che la parola chiave Select è usata sia per in- 
terrogare il database che per assegnare dei valori ai 
parametri. 



CONCLUSIONE 

Gli argomenti introdotti in questo articolo - mo- 
dello Three-Tier, Moduli di Classe, Stored Procedu- 
re ecc. - meritano un accurato approfondimento 
dato che costituiscono le fondamenta delle appli- 
cazioni Clienti 'Server . . . buon lavoro. 

Massimo Autiero 
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CREARE CONTROLLI 
PERSONALIZZATI CON .NET 

IL .NET FRAMEWORK PERMETTE LA CREAZIONE DI CONTROLLI NUOVI 

PER LA PERSONALIZZAZIONE DELLE APPLICAZIONI WINDOWS, CON IL SUPPORTO 

DI AVANZATI MECCANISMI DI LICENSING PER LA LORO DISTRIBUZIONE 




Q CD Q WEB 

customcontrols.zip 



^j- 



o 




REQUISITI 



■jj.i.wmiw.imM 

Conoscenze medie 
1 diC# 



.NET Framework, 
Microsoft Visual Studio 
.NET 



J J J 



Tempo di realizzazione 



Lo sviluppo di custom controls, o controlli 
personalizzati, è un tema chiave del fra- 
mework .NET. In generale essi rendono F ar- 
chitettura di un'applicazione più riutilizzabile e 
portabile, in quanto lo stesso controllo, progetta- 
to come si deve, esponendo la giusta dose di pro- 
prietà per la sua personalizzazione, potrà essere 
riutilizzato senza fatica in diverse applicazioni. 
Creare controlli custom in .NET è notevolmente 
più semplice dell'implementazione che un tem- 
po, sempre più lontano, veniva fatta tramite con- 
trolli ActiveX in C++ o in Visual Basic. Controlli che 
spesso portavano al classico problema conosciu- 
to come DLL Hell, in quanto ogni versione doveva 
essere registrata nel sistema operativo, per non 
parlare degli altri problemi che si incontravano In 
.NET creare un custom controls non differisce mol- 
to dal creare una classe qualunque, basta eredita- 
re dalla classe madre giusta. 



TIPI DI CUSTOM 
CONTROLS 

Ci sono diverse possibilità per creare dei control- 
li personalizzati da utilizzare nelle nostre appli- 
cazioni, il modo più frequente è quello di deriva- 
re un controllo dalla classe UserControl ed utiliz- 
zare una sorta di composizione di altri controlli, 
standard oppure personalizzati anch'essi. Un'al- 
tra modalità e quella di derivare dalla classe 
Control ed utilizzare GDI+ per disegnare l'inter- 
faccia grafica. Questi controlli, detti anche ow- 
ner-drawn, sono quelli più customizzabili, ma 
naturalmente richiedono più sforzi di sviluppo. 
La classe Control infatti è più alta nella gerarchia 
di ereditarietà rispetto alla classe UserControl: 

System. Object 
System. MarshalByRefObject 
System.ComponentModel.Component 
System. Windows. Forms. Control 
System. Windows. Forms.ScrollableControl 
System. Windows. Forms. ContainerControl 



System. Windows. Forms. UserControl 
System. Windows. Forms. Form 

Notate come UserControl sia allo stesso livello della 
classe Form, quindi come vedremo ne condivide 
molte funzionalità e comportamenti, ed il fatto che 
derivi da ContainerControl permette di contenere 
altri controlli proprio come una Form. 
Se si vuole invece estendere un controllo esistente 
con nuove funzionalità, si può derivare direttamen- 
te dalla sua classe e personalizzarlo secondo le di- 
verse esigenze. Naturalmente non esiste una linea 
guida da seguire in maniera precisa, ognuno si com- 
porterà come meglio ritiene al momento di svilup- 
pare un nuovo controllo. 



IL SUPPORTO DI VISUAL 
STUDIO.NET 2005 

Visual Studio .NET 2005, ma anche le versioni pre- 
cedenti, forniscono un ottimo supporto nella realiz- 
zazione e nell'utilizzo di custom controls. 
Il primo passo è creare un nuovo progetto, e sceglie- 
re come tipologia Windows Control Library oppu- 
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Fig.l: Creare un progetto di controlli 

re Class Library (vedi Figura 1). 
Non fa molta differenza, in quanto entrambi per- 
metteranno di creare un assembly .NET, da referen- 
ziare nelle nostre applicazioni. Il primo comunque 
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creerà anche un file 
UserControll.es, 
scheletro di classe da 
utilizzare per creare 
un controllo derivan- 
te da UserControl In 
ogni caso, per aggiun- 
gere un nuovo User- 
Control al progetto, 
basta cliccare con il 
tasto destro, nella fi- 
nestra Solution Ex- 
plorer, sul nome del 
progetto, e seleziona- 
re la voce Add/User 
Control (Figura2). Il 
designer di Visual 
Studio permette a questo punto di progettare il con- 
trollo aggiungendo elementi standard sulla sua 
superficie, altri usercontrols, e di impostarne le clas- 
siche proprietà, ad esempio dimensione, colore di 
sfondo, e così via, in maniera perfettamente analoga 
a ciò che siamo abituati a fare con una Form. Visual 
Studio 2005 ha aggiunto la possibilità di avviare un 
progetto di tipo Windows Control Library. Infatti 
all'avvio del debug viene creato un contenitore dei 
controlli contenuti nella libreria attraverso il quale 
interagire con esso e testarlo (Figura 3). 



Fig.2: Aggiungere uno user 
control al progetto 
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Fig.3: Il test container di VS2005 per gli user control 

Per testare il nostro usercontrol nella edizione 2003 
avremo invece bisogno di una applicazione Win- 
dows Forms che lo utilizzi. Quindi aggiungiamo alla 
soluzione un nuovo progetto WindowsApplication, 
chiamandolo ad esempio TestApplication. Perché 
l'applicazione possa utilizzare il controllo, dobbia- 
mo aggiungere fra i riferimenti l'assembly dell'altro 
progetto. In questo caso dopo aver cliccato su Re- 
ferences, bisogna selezionare la scheda Projects e 
selezionare il progetto contenente lo UserControl. 
Già questo è sufficiente per utilizzare nel vostro co- 
dice il controllo personalizzato. Se volete anche la 
comodità di trascinarlo dalla barra degli strumenti 
data uno sguardo al box apposito che spiega come 
personalizzare sia la toolbox che l'icona che con- 
traddistingue il controllo. 



jd-x] 



.NET | COM Projects | Browse | Recent | 



Project Name 
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Fig.4: Aggiungere il riferimento alla libreria 
dei controlli 



L'IPADDRESSCONTROL 

Una volta creato il progetto Windows Control Li- 
brary, è possibile iniziare la personalizzazione del 
nostro controllo. Supponiamo di voler realizzare un 
controllo che permetta l'inserimento e la convalida 
di un indirizzo IP, nel formato classico aaa.bbb.ccc. 
ddd, cioè 4 gruppi di numeri da a 255. Basta inse- 
rire sulla superficie del controllo 4 textbox, una la- 
bel, ed aggiungere un errorProvider per indicare l'in- 
serimento di valori non consentiti. Per consentire 
solo l'inserimento di valori numerici, basterà gestire 
l'evento KeyPress, con un metodo che associeremo 
a tutte quante le TextBox: 

private void textBoxes_KeyPress(object sender, 

KeyPressEventArgs e) 

{ 

if (char.IsDigit(e.KeyChar) || e.KeyChar = = 

(char)Keys.Back) 
{ e.Handled = false; } 



else e.Handled = true; 



- > 



invece per verificare che i valori inseriti nelle caselle 
siano compresi fra e 255, intanto limiteremo la 
lunghezza massima delle stringhe inserite a 3 carat- 
teri, impostando la proprietà MaxLength di Text- 
Box. Inoltre, gestendo l'evento TextChanged, si po- 
trà verificare che il valore di ogni TextBox sia nel ran- 
ge consentito, ed in caso negativo impostare l'error- 
Provider. 

private void textBoxes_TextChanged(object sender, 

EventArgs e) 

{ 

TextBox txt = sender as TextBox; 



try 



if (txt.Text == "") 



errorProvider.SetError(txt, ""); 



else 



int i = Convert.ToInt32(txt.Text); 



if (i < || i > 255) 





I TUOI APPUNTI 



{ errorProvider. SetError(txt, "Inserire un 
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valore fra e 255"); } 


else erTorProvider.SetError(txt, ""); } } 


catch 


{ errorProvider.SetError(txt, "Inserire un 

valore fra e 255"); } 


} 



Ogni user control può naturalmente definire le pro- 
prie proprietà pubbliche, che potranno essere usate 
anche nel designer di VisualStudio. In questo caso, 
ad esempio, creiamo una proprietà IPAddress che 
restituisca l'IP impostato nel controllo, sotto forma 
di stringa, e viceversa per effettuare un parsing di 
una stringa nel formato classico di un indirizzo IP: 



prietà pubbliche, che però non volete rendere visibi- 
li nella griglia delle proprietà, a design time, basta 
applicare l'attributo Browsable alla proprietà con 
parametro false, ad esempio: 

[Browsable(false)] 
public string IPAddress 



Un altro attributo utile è Category, che permette di 
visualizzare una proprietà in una determinata cate- 
goria della griglia. Ad esempio se si vuol visualizzare 
la proprietà precedente nella categoria Data, baste- 
rà scrivere: 
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public 


string IPAddress 


{ get 


{ 


return Stnng.Format("{0}.{l}.{2}.{3}", 

textBoxl.Text, textBox2.Text, 
textBox3.Text, textBox4.Text); } 


set 


{ 


try 


{ 


string[] values = value.Split('.'); 


textBoxl.Text = values[0]; 


textBox2.Text = values[l]; 


textBox3.Text = values[2]; 


textBox4.Text = values[3]; } 


catch 


{ IPAddress = "..."; } 


} 


} 



[Category("Data")] 
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Fig.5: L'IPAddressControl nel test container 

La Figura 5 mostra il controllo nel TestContainer, 
con l'error provider attivo sul terzo blocco di cifre, e 
la proprietà IPAddress visibile nella PropertyGrid di 
destra. Se il controllo custom possiede delle pro- 



public string IPAddress 



CONTROLLI 
OWNER DRAWM 

Una seconda possibilità di sviluppo di controlli 
custom, è quella che prevede l'intero disegno del 
controllo con le classi ed i metodi GDI+. In questa 
maniera si ha la possibilità di una personalizzazione 
molto più spinta e quindi di poter progettare e rea- 
lizzare controlli completamente nuovi. Supponiamo 
ad esempio di voler utilizzare nella nostra applica- 
zione dei pulsanti rotondi. Le strade sono due, o 
compriamo un controllo già fatto, o ce lo costruiamo 
da soli. Scegliamo la seconda. Intanto bisogna crea- 
re una nuova classe, chiamandola ad esempio 
RoundButton e derivandola da Control Per il no- 
stro pulsante vogliamo inoltre la possibilità di impo- 
stare i colori del bordo, quello di sfondo, cambiando 
quest'ultimo quando esso viene cliccato e quando il 
puntatore del mouse ci si muove sopra. Dunque alla 
classe aggiungeremo i campi necessari a mantenere 
tali possibili colori e stati: 



publi 


e class RoundButton : Control 


{ 




private 


Color borderColor; 




private 


Color fillColor; 




private 


Color hoverColor; 




private 


Color clickedColor; 




private 


bool clicked; 




private 


bool hover; 


} 



Per i campi Color è utile aggiungere le relative pro- 
prietà public, in maniera da utilizzarle anche a De- 
sign Time, quando si aggiungerà il pulsante su una 
Form. Ad esempio la proprietà FillColor sarà la se- 
guente: 

[RefreshProperties(RefreshProperties.Repaint), 
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Category("Appearance"), 
Description("Colore di riempimento")] 



public Color FillColor 



{ 



get 



{ return fillColor; } 



set 



fillColor = value; 



InvalidateQ; 



EventArgs e) 



hover = true; 



InvalidateQ; } 



private void RoundButton_Mousel_eave(object sender, 

EventArgs e) 



{ 



hover = false; 



InvalidateQ; 



} 




} 



Il metodo che effettua il disegno di un controllo è il 
metodo OnPaint, ed è dunque necessario effettuar- 
ne Foverride, distinguendo le diverse modalità di 
disego del pulsante, a seconda dello stato in cui esso 
si trova: 

protected override void OnPaint(PaintEventArgs e) 
{ 

Graphics graphics = e. Graphics; 
int penWidth = 4; 

Pen pen = new Pen(borderColor, 4); 
SolidBrush brush; 

if (clicked) 

brush = new SolidBrush(clickedColor); 
else 



if (hover) 

brush = new SolidBrush(hoverColor); 
else 
{ brush = new SolidBrush(fillColor); } 

} 

int x = clicked ? 2 : 0; 

graphics. FillEllipse(brush, x, x, Width-x, 

Height-x); 



La Figura 6 mostra una Form con due RoundBut- 
ton, uno dei quali è evidenziato al passaggio del 
mouse. 



SolidBrush textBrush 



new SolidBrush( 

ForeColor); 



graphics. DrawEllipse(pen, (int)penWidth / 2+x, 
(int)penWidth / 2+x, Width - penWidth-x, 
Height - penWidth-x); 
graphics. DrawString(Text, Font, textBrush, 

penWidth, Height/ 2 - Font.Height); 



} 



Ciò che modificherà lo stato del RoundButton sarà 
naturalmente l'interazione dell'utente, per mezzo 
del mouse. Quindi basterà gestire in maniera classi- 
ca gli eventi del mouse e variare i valori dei campi 
della classe. Ad esempio quando il puntatore del 
mouse entra sulla superficie del pulsante, basterà 
impostare a true il campo hover, e forzare un ridise- 
gno invalidando la superficie del controllo. Vicever- 
sa, quando il mouse abbandona l'area del pulsante 
si riporterà di false tale campo: 

private void RoundButton_MouseEnter(object sender, 




Fig. 6: Pulsanti tondi 



LICENSING 
DEI CONTROLLI 

Una volta che abbiamo creato il nostro bel control- 
lo, e siamo pronti a distribuirlo, magari vorremmo 
anche avere la possibilità di difenderci dall'utilizzo 
non autorizzato, cioè implementare qualche mecca- 
nismo di Licensing, che sia valido non solo a runti- 
me, ma anche a design time. Il .NET framework pos- 
siede un modello di licensing integrato, utilizzabile 
sia per controlli Windows che per web controls, ed 
inoltre totalmente compatibile con gli ActiveX. La 
validazione della licenza viene svolta in questo 
modello da una classe che deriva dalla classe astrat- 
ta LicenseProvider. La classe LicFileLicenseProvi- 
der è una semplice implementazione che utilizza un 
file di licenza fornito assieme al controllo. Natural- 
mente se avete in mente di distribuire commercial- 



AGGIUNGERE IL CONTROLLO ALLA TOOLBAR 



Per aggiungere un custom control 
alla barra degli strumenti di Visual 
Studio, basta cliccare con il tasto 
destro sulla tool box, e selezionare 
la voce Choose Items, a questo 
punto, fate clic sul pulsante Browse 
e ricercate l'assembly che contiene 
il controllo. Una volta selezionatolo 
cliccate su Off ed esso apparirà 
sulla barra. Se desiderate persona- 
lizzare l'icona di default (la ruota 
dentata), non dovete far altro che 



aggiungere un file bitmap al pro- 
getto, nelle sue proprietà imposta- 
re embedded resource come build 
action e quindi aggiungere l'attri- 
buto ToolboxBitmap alla classe del 
controllo, specificando il percorso 
dell'immagine nell'assembly, ad 
esempio: 

[System. Drawing.ToolboxBitmap(typeof( 
IPAddressControl), 
"TuoNamespace.Immagine.bmp")] 
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mente i vostri controlli, questo meccanismo non è 
sufficiente, ma è utile per mostrare il funzionamen- 
to del licensing. Il primo passo è utilizzare l'attribu- 
to LicenseProvider, in questo caso con parametro 
LicFileLicenseProvider, applicandolo alla classe 
che implementa il controllo, ed aggiungere un cam- 
po License. 

[LicenseProvider(typeof( LicFileLicenseProvider))] 

public partial class RoundButton : Control 

{ 

private License license = nuli; 



for more information. 

In parole povere manca un file di licenza valido. 
Con l'implementazione standard LicFileLicense- 
Provider basta creare un file con nome uguale al no- 
me completo di namespace della classe che imple- 
menta il controllo ed estensione .LIC, nel nostro 
caso sarà un file WindowsControlLibrary. Round- 
Button.LIC, ed inserire il testo seguente: 

WindowsControlLibrary.RoundButton is a licensed 

component. 



' >> CONTATTA 
f 'j L'AUTORE 



Potete rivolgere do- 
mande di chiarimenti o 
ulteriori richieste 
all'autore all'indirizzo 

antonio.pelleriti@ 

ioprogrammo.it 

o ancora sul forum di 

ioProgrammo 

http://forum 

.ioprogrammo.net 

o sul sito 

www.dotnetarchitects.it 



> 



Nel costruttore della classe è ora necessario invoca- 
re il metodo statico Validate della classe License- 
Manager, che, se tutto è ok, restituirà un oggetto Li- 
cense con cui inizializzare il campo license. 

public RoundButton() 
{ 

license = LicenseManager.Validate( 

typeof(RoundButton), this); 

y~ 

Il metodo Validate, se non trova un file di licenza 
valido, genera una eccezione LicenseException, im- 
pedendo dunque la creazione del custom control, 
sia a runtime che a design-time, dato che anche il 
designer internamente cerca di creare un'istanza del 
controllo. Infine, nel finalizzatore della classe, o co- 
munque prima dell'esecuzione del finalizzatore, è 
necessario invocare il metodo Dispose del campo 
license: 

if (license != nuli) 
{ 

license. Dispose(); 

license = nuli; 

y~ 

Non resta che creare il file di licenza. Ma prima pro- 
vate ad utilizzare il vostro controllo in un progetto 
Windows Forms, e verificate che viene generata l'ec- 
cezione con un messaggio del tipo: 

Exception occurred creating type 

'WindowsControlLibrary. RoundButton, 

WindowsControlLibrary, Version = 1.0.1.0, 

Culture=neutral, PublicKeyToken = nuH' 

System. ComponentModel. LicenseException: An 

instance of type 'WindowsControlLibrary.RoundButton' 

was being created, and a valid license could 

not be granted for the type 

'WindowsControlLibrary. RoundButton'. Please, 

contact the manufacturer of the component 



Non dimenticate il punto finale. Tale file deve essere 
presente nella directory di output, quella cioè dove 
visual studio compila l'eseguibile. In Visual Studio 
2005, basta impostare la proprietà Copy to output 
del file al valore Copy always. Se provate adesso a ri- 
compilare la soluzione, vedrete che va tutto a posto. 
Come già detto un file di licenza così semplice, e con 
un testo predefinito, non è il massimo della sicurez- 
za. Quindi bisogna adottare un meccanismo di veri- 
fica del file più forte, ad esempio ereditando dalla 
classe LicFileLicenseProvider una nuova classe, ed 
effettuando l'override del metodo IsKeyValid: 



class 


MyFileLicenseProvider: LicFileLicenseProvider 


{ 


protected override bool IsKeyValid(string key, 

Type type) 


{ 


if (key.IndexOf("123456789")> = 0) 


return true; 


return false; 


} 


} 



Il metodo IsKeyValid prende in ingresso il parame- 
tro key che sarà inizializzato al contenuto del file 
LIC In questo caso il metodo restituisce true se il file 
contiene la stringa "123456789". A questo punto po- 
tete sbizzarrirvi a creare modalità di verifica più 
complesse del file di licenza, oppure derivando una 
classe direttamente dalla classe astratta LicensePro- 
vider e quindi senza essere legati per forza ad un file. 



CONCLUSIONI 

Abbiamo visto come procedere nell'implementazio- 
ne di un controllo personalizzato per applicazioni 
Windows Forms, derivandolo dalla classe UserCon- 
trol, e quindi come composizione di controlli stan- 
dard, o disegnando by scratch la sua interfaccia, 
arrivando infine ai meccanismi di licensing dei com- 
ponenti e controlli .NET. Siete pronti ad iniziare la 
vostra avventura nel mondo dei custom controis? 

Antonio Pelleriti 
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Servizio di comunicazione asincrona su Windows dal 1997 



MSMQ: OVERVIEW 
ARCHITETTURALE 

MSMQ È IL SERVIZIO WINDOWS CHE FACILITA LA COMUNICAZIONE ASINCRONA FRA 
APPLICAZIONI PER TUTTI GLI SCENARI IN CUI LE PARTI POSSONO ESSERE IRRANGIUNGIBILI 
OFFLINE O LAVORARE A VELOCITÀ DIVERSE 




REQUISITI 



nessuna 



I 



.NET Framework 1.x o 
2.0 per testare il codice 
presentato 



aai 



Tempo di realizzazione 







Quante volte abbiamo cercato qualcuno 
al telefono e lo abbiamo trovato al pri- 
mo colpo? Quante volte abbiamo ri- 
tentato la telefonata senza successo perdendo 
minuti preziosi ? La soluzione "telefonica" al 
problema citato è arrivata un bel po' di tempo 
fa con l'invenzione delle segreterie telefoni- 
che: "Marco, sono Roberto, ti volevo comunica- 
re che domani la riunione è spostata alle 1 7". 
La filosofia delle comunicazioni asincrone è 
più o meno questa. 

Registriamo su un supporto il messaggio che 
l'interlocutore "off-line" o impegnato potrà 
ascoltare non appena disponibile. I due inter- 
locutori non parlano direttamente tra loro, ma 
tramite messaggi memorizzati in uno store (na- 
stro nel caso delle segreterie telefoniche). La 
posta elettronica è un esempio informatico 
concreto di comunicazione asincrona in quan- 
to i due interlocutori non sono direttamente 
connessi, non devono conoscere la posizione 
fisica l'uno dell'altro, ma si scambiano infor- 
mazioni tramite un servizio che si preoccupa di 
instradare il messaggio fino a raggiungere la 
casella postale del destinatario. Per definizio- 
ne l'email è asincrona: non possiamo, ne do- 
vremmo, aspettarci una risposta immediata; 
possiamo solo inserire un flag di priorità in 
modo che il destinano possa discriminare i va- 
ri messaggi da processare. La posta elettronica 
è un ottimo sistema di scambio di informa- 
zioni fra "umani", ma dimostra subito i suoi li- 
miti quando viene impiegata per altri scopi, 
quali lo scambio di dati fra applicazioni. 



PERCHE MSMQ ? 

MSMQ si basa sugli stessi principi, ma è stato 
progettato nello specifico per comunicazioni 
application- to- application e si propone co- 
me servizio per lo scambio di messaggi fra 
applicazioni, fornendo maggior velocità, 



semplicità e soprattutto garanzie rispetto alla 
posta elettronica. 



QUANDO? 

Pensiamo ad un sito web pubblico che con- 
sente l'acquisto online; se la comunicazione 
con l'istituto di credito è interrotta o troppo 
lenta come ci comportiamo? 
Le strade sono due: 

1) Ci scusiamo con l'utente chiedendogli se 
per favore può riprovare più tardi. Più 
tardi quanto? 1 minuto? 10 minuti? 1 gior- 
no? Fra quanto la linea sarà di nuovo "in 
palla" come dovrebbe. E se la transazione 
è lenta? Facciamo aspettare l'utente 5 
minuti sulla pagina? 

2) Accodiamo la richiesta da qualche parte, 
informiamo l'utente che il suo acquisto è 
in fase di "processing" e che riceverà una 
comunicazione sull'esito della transazio- 
ne. 

Se fossi io a progettare il sito di commercio 
elettronico, proporrei la seconda soluzione 
per vari motivi, non solo commerciali: 

• Ci garantiamo acquisti anche in caso di 
caduta di linea (motivo commerciale) 

• Non rallentiamo la fase di acquisto per 
lentezza del partner commerciale o della 
linea 

• Non blocchiamo un thread (preziosissi- 
mo) per qualche minuto se la linea è 
lenta: si veda il box laterale: 

Un altro esempio per allargare lo scenario: 
pensiamo ad un agente commerciale che 



► 78 /Aprile 2006 



http://www.ioprogrammo.it 



Servizio di comunicazione asincrona su Windows dal 1997 ■ T SISTEMA 



raccoglie ordini direttamente dal cliente tra- 
mite il suo palmare. Ogni ordine deve essere 
trasmesso alla sede; anche in questo caso ab- 
biamo due strade: 

1) Trasmettiamo l'ordine immediatamente 
con il rischio che, se la linea GPRS/UMTS 
non è disponibile, l'agente debba prende- 
re per mano il cliente, uscire dall'azienda, 
cercare insieme una zona coperta per in- 
viare l'ordine, tornare nello stabile, pren- 
dere un altro ordine e uscire di nuovo ma- 
no nella mano con il cliente per premere 
il pulsante "Invia" 

2) Ogni ordine viene memorizzato local- 
mente e inviato quando l'agente ritrova la 
connettività. 
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Fig. 1: I servizi da installare per provare le tecniche 
descritte 

A prescindere dalle tecnologie disponibili per 
gestire questi semplici scenari, in entrambi i 
casi la soluzione 2 è sicuramente preferibile. 
Arriviamo subito al punto: dove memorizzia- 
mo queste richieste da inviare "non appena 
possibile" (potrebbe voler dire che la sera l'a- 
gente invia tutti gli ordini della giornate se 
non è indispensabile processarli il prima 
possibile)? Spesso la soluzione che ci inven- 
tiamo è costruire una tabella in un database 
locale dove memorizzare le informazioni 
(non l'ordine) sul cliente, gli articoli ordinati, 
il tipo di pagamento scelto etc) che verrano 
spedite a qualche entità server side (Web 
Service per esempio) al momento in cui 
ritroviamo la connettività. Dobbiamo gestire 
noi stessi la frequenza di invio, l'eventuale 
priorità con cui spedire i record (forse ha più 
senso processare prima gli ordini di clienti 
importanti oppure gli acquisti di maggior 
valore) e soprattutto le politiche transaziona- 
li con cui inviare il messaggio. Quest'ultimo è 
il punto più importante: quando cancello il 



record dalla tabella locale? Come faccio a es- 
sere sicuro che sia arrivato a destinazione? 
Quando levo il record dalla tabella di desti- 
nazione? Quando sono sicuro che l'applica- 
zione remota lo abbia processato. E se l'ope- 
razione non va a buon fine? Ad esempio non 
si può prendere l'ordine perché il cliente è 
insolvente: come avverto l'applicazione ini- 
ziale sull'esito dell'operazione? 



LE CARATTERISTICHE 
DI MSMQ 

Facciamo entrare in gioco un prodotto nato 
per gestire queste problematiche: Microsoft 
Message Queue. È disponibile in versione 1.0 
dal 10 marzo 1997, si è evoluto in versione 2 e 
3 su Windows 2000/2003/XP e dal 1999 è di- 
sponibile anche per piattaforma Windows CE 
3.0. L'idea è molto semplice: il Sender scrive 
un messaggio all'interno di una coda gestita 
dal servizio e il Receiver andrà a leggere il 
messaggio dalla medesima coda. 
MSMQ garantisce il recapito, il routing (in- 
stradamento), la sicurezza durante il traspor- 
to e fornisce interfacce di programmazione 
per accedere in lettura/ scrittura alle code. 
Il prodotto si colloca in una realtà distribuita 
in cui le comunicazioni fra i vari componen- 
ti software che costituiscono l'applicazione 
girano su macchine diverse, macchine che 
possono essere connesse da linee non sem- 
pre attive {Dial-up, VPN, GPRS, ecc.), oppure 
quando è necessario far comunicare applica- 
zioni che girano su sistemi operativi differen- 
ti e/o non si vuole che problemi di rete pos- 
sano fermare o rallentare l'esecuzione. Le co- 
municazioni asincrone risolvono anche l'an- 
noso problema delle performance. 
Già, perché il tempo necessario per scrivere 
un messaggio in una coda può essere consi- 
derato quasi uguale a zero, mentre attendere 



THREAD PREZIOSISSIMI IN ASP.NET? 



.net 





I TUOI APPUNTI 



Già, i thread sono risorse prezio- 
sissime per tutti gli ambienti ser- 
ver-side. ASP.NET, per default, di- 
spone di 25 thread (per ogni pro- 
cessore su macchine Dual Core o 
Multiprocessore) per processare 
tutte le richieste Http relative 
alle applicazioni ospitate nello 
stesso processo (in MS 5 tutte le 
applicazioni ASP.NET sono ospita- 
te nello stesso processo). 
Premesso che tale numero si può 
alzare da configurazione, liberare 



il prima possibile un thread si- 
gnifica avere più risorse per pro- 
cessare le richieste. Non è mai 
una buona idea aumentare il nu- 
mero di thread se il server non 
riesce a processare le richieste in 
quanto il costo di thread switch 
è elevato. A tal proposito si veda 
un'introduzione a IHttpAsync- 
Handler e ASP.NET 2.0 Async si 
veda: http://blogs.devleap.com 
/articolidevleap/archive/2006/01/12 
/6505.aspx 
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una comunicazione sincrona con un'applica- 
zione più lenta, su una connessione di rete 
lenta, significa rallentare anche T applicazio- 
ne chiamante. Pensiamo anche, ad esempio, 
alle problematiche di replica dei dati da un 
database installato su quadriprocessore 
Xeon con 8 Gb di RAM verso un database di 
bakcup situato su una macchina Pentium IV 
monoprocessore con 1 Gb di RAM: la nostra 
super macchina è costretta a "rallentare" per 
adeguarsi alla velocità del Pentium IV; ulte- 
riore rallentamento si avrebbe se le due mac- 
chine fossero connesse con un collegamento 
non troppo veloce oltre al fatto che comun- 
que le due macchine debbano entrambe ri- 
manere online per tutta la durata della repli- 
ca.In una comunicazione sincrona le richie- 
ste sono processate nell'ordine in cui vengo- 
no inviate dal chiamante, mentre con un 
sistema di messaggistica è possibile assegna- 
re una priorità ad ogni messaggio. 
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Fig. 2: L'interfaccia di amministrazione 



Un crash nella comunicazione sincrona cau- 
sa un rollback, cioè un annullamento di tutte 
le operazioni effettuate (e molto spesso un 
messaggio di errore per l'utente), mentre 
MSMQ può eseguire un numero di retry 
impostabile dall'applicazione. È possibile 
definire il tempo massimo il cui il messaggio 
può raggiungere la coda di destinzione e un 
tempo massimo in cui il messaggio deve es- 
sere letto. In caso di timeout è il servizio 
MSMQ che si incarica di inserire un messag- 
gio amministrativo di mancato recapito o 
mancata lettura che, sempre tramite le API, è 
possibile recuperare e interpretare. 



Nel caso in cui un certo numero di client ef- 
fettuano richieste sincrone di aggiornamento 
dati occorre definire una politica di lock sulle 
risorse rallentando o terminando l'operazio- 
ne di aggiornamento nel caso in cui la risorsa 
sia bloccata. Una coda non ha nessun pro- 
blema di concorrenza in quanto i messaggi 
vengono inseriti e accodati dalle varie appli- 
cazioni Sender. L'applicazione Receiver pro- 
cesserà i messaggi uno ad uno e quindi effet- 
tuerà degli aggiornamenti "sequenziali" sulle 
risorse. Quest'ultimo punto è discutibile in 
quanto potrebbero esistere più applicazioni 
Receiver per ragioni di performance o Fault- 
tolerance, o più semplicemente il Receiver 
potrebbe girare multithread facendo riemer- 
gere il problema dei lock sulla risorsa finale. 
Anche in questo caso però abbiamo spostato 
il problema dall'applicazione che l'utente 
usa (applicazione web, Windows o mobile) 
all'applicazione receiver, liberando così il 
front-end dalle problematiche descritte. 
L'applicazione sender può scrivere in una 
coda locale o in una coda remota senza pre- 
occuparsi della connettivtà verso la coda. 
MSMQ tiene il messaggio in locale per poi 
spedirlo nella coda remota appena viene 
ritrovata la connettività: non occorre quindi 
definire una coda locale sul palmare dell'a- 
gente commerciale visto nel caso preceden- 
te; l'applicazione scriverà sempre nella coda 
aziendale e sarà MSMQ a incaricarsi della 
spedizione non appena il palmare verrà con- 
nesso alla struttura aziendale. 
L'architettura del prodotto consente configu- 
razioni molto complesse integrate con domi- 
ni, sedi remote, bridge verso prodotti di terze 
parti, integrazione con Active Directory, ma 
proviamo a partire dal caso più semplice: un 
sito web che accoda delle richieste che ven- 
gono poi "scodate" da un'applicazione che si 
incarica di effettuare il vero lavoro. 
Torneremo poi sui dettagli architetturali e al- 
tri scenari in un prossimo articolo. 



PRIME PROVE 

Per iniziare è sufficiente installare su macchi- 
na singola (non complichiamoci la vita con 
macchine diverse per adesso, ribadisco però 
che la location delle code è indipendente) il 
MSMQ presente fra i componenti di Win- 
dows. Una volta installato il prodotto da 
"Computer Management" -> Services and Ap- 
plications appare la voce Message Queuing. 
Sotto Private Queue si può creare ammini- 
strativamente una nuova coda assegnando 
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un nome qualunque. Le code private si rag- 
giungono dalle applicazioni {Sender o Re- 
ceivef) tramite il proprio path corrisponden- 
te a "nomemacchìna\private$\nomecoda". Si 
possono usare vari formati e protocolli, e si 
possono creare code anche da codice (aven- 
do il permesso di farlo) ma per adesso con- 
centriamoci sul caso più semplice. Per de- 
fault una coda ad accesso a Everyone quindi 
per fare qualche prova non ci dovrebbero es- 
sere problemi di security. 
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Fig. 3: Visualizza i messaggi in una coda 

Un'applicazione che vuole inviare un mes- 
saggio in coda dovrà referenziare la libreria 
.NET System.Messaging (sia in .NET l.x che 
2.0), creare un oggetto MessageQueue che 
rappresenta la coda e un oggetto Message che 
rappresenta il messaggio da spedire nella 
coda. Ecco un estratto di codice C# di un'ap- 
plicazione Windows Form che invia un mes- 
saggio nella coda u gondor\private$\testm- 
smq" dove in questo caso "gondor" è il nome 
della mia macchina. 



using System.Messaging; 



L'esempio, molto semplice, utilizza il pattern 
C# using per eseguire la Dispose dell'oggetto 
che rappresenta la coda e il tipo Message- 
QueueException per intercettare eventuali 
problemi durante l'invio del messaggio. 
Se il messaggio viene recapitato in coda sen- 
za errori, sempre da Computer Management , 
eseguendo un refresh su Queue Message nella 
coda si potrà visualizzare e analizzare il mes- 
saggio. Come si può notare al messaggio vie- 
ne assegnato un ID, viene riportato il sender, 
le informazioni sull'arrivo e il body del mes- 
saggio stesso. In questo caso il contenuto del 
messaggio è la stringa indicata appunto nel 
body dall'applicazione sender. Il messaggio, 
per default, viene serializzato in XML all'in- 
terno della coda: non c'è nessun bisogno di 
convertire la stringa in XML quanto il For- 
matter di default (cioè colui che si incarica di 
serializzare il messaggio) è XmlMessageFor- 
matter. Parleremo di serializzazione XML e di 
classi custom in un prossimo articolo. 
L'applicazione che deve ricevere i messaggi e 
processarne il contenuto utilizzerà sempre la 
classe MessageQueue per indicare la coda da 
cui prelevare il messaggio e il metodo Recei- 
ve per estrarre il messaggio dalla coda. 
Ecco il codice: 



using System.Messaging; 



try 



using(MessageQueue mq = new MessageQueue( 
"gondor\private$\testmsmq")) 



{ 



mq.Formatter = new XmlMessageFormatter( 
new Type[] { typeof(String) }); 



// Ricezione del messaggio 



try 



Message messageReceived = mq.Receive(); 
String contenuto = (String) 

messageReceived . Body; 



.net 





fi> CONTATTA 
L'AUTORE 



Potete rivolgere do- 
mande di chiarimenti o 
ulteriori richieste 
all'autore agli indirizzi: 

www.DevLeap.com 
http://blogs.devleap.com 
/rob 
http://thinkmobile.it 



using(MessageQueue mq = new MessageQueue( 
"gondor\private$\testmsmq")) 



{ 



Message messaggio = new Message(); 
messaggio. Body = "Ciao dal Sender"; 



mq.Send(messaggio); 



} 



MessageBox.Show("Inviato!"); 



> 



catch (MessageQueueException ex) 



{ 



MessageBox.Show("Errore invio"); 



} 



catch (MessageQueueException ex) 



{ 



MessageBox.Show("Errore invio"); 



} 



Per ricevere correttamente un messaggio è 
necessario indicare il tipo di contenuto (tipo 
inteso nel senso .NET: la classe) che il Messa- 
ge Formatter si incaricherà appunto di for- 
mattare. Per prima cosa, quindi, nel nostro 
caso, indichiamo all'oggetto MessageQueue 
che il suo formatter è un XmlMessageFormat- 
ter che dovrà trattare il tipo String per dese- 
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rializzare il contenuto del Body. Il metodo 
Receive restituisce un oggetto di tipo Message 
corrispondente al messaggio estratto dalla 
coda. È sufficiente poi ricovertire il corpo del 
messaggio nel suo tipo (classe) originale. Il 
metodo Receive elimina il messaggio dalla 
coda... scoda in poche parole. In questo 
esempio, il contenuto del messaggio è una 
semplice stringa che "non dice molto" all'ap- 
plicazione che riceve il messaggio: è impor- 
tante capire che il contenuto del messaggio è 
a cura dello sviluppatore (o meglio del pro- 
gettista della soluzione basata su MSMQ) e 
quindi non esistono messaggi preconfezio- 
nati. Il body deve essere significativo per 
l'applicazione Sender e per l'applicazione 
Receiver. 



Appuntamenti Properties 



General Queues Sender \ Body J 
T he bo by tes. 



3C 


3F 


78 


6D 


6C 


20 


76 


65 


72 


<?xml ver 


73 


69 


6F 


6E 


3D 


22 


31 


2E 


30 


sion=" 1 . 


22 


3F 


3E 


OD 


OA 


3C 


73 


74 


72 


"?> . .<str 


69 


6E 


67 


3E 


41 


70 


70 


75 


6E 


ing>Àppun 


74 


61 


6D 


65 


6E 


74 


6F 


20 


63 


tamento e 


61 


73 


61 


20 


33 


37 


3C 


2F 


73 


asa 37</s 


74 


72 


69 


6E 


67 


3E 








trincp 



Fig. 4: il body del messaggio memorizzato in XML 
all'interno di una coda 



Ad esempio un body reale di una mia vecchia 
applicazione è "APPT:36; DAY:200 1/0 1/09; 
TIME:12-00;DURATION:2" che indica un ap- 
puntamento per il giorno 9/1/2001 alle ore 
12.00 per due ore con ID 36. In questo caso la 
stringa viene composta e spacchettata dalle 
due applicazioni. Nella versione successiva 
dell'applicativo tale contenuto viene invece 
espresso in XML tramite la serializzazione 
automatica della classe Appuntamento defi- 
nita fra le entità del progetto. Adesso che 
abbiamo capito la filosofia di base di 
Microsoft Message Queue e visto il codice per 
spedire e ricevere un messaggio, vediamo 
alcune opzioni di delivery che consentono di 
dare una priorità ai messaggi, di tracciare la 
spedizione e la ricezione. In molti scenari ha 
senso suddividere le tipologie di messaggio 
da spedire /ricevere in base a diversi criteri; 
potremmo, ad esempio, dover inviare mes- 
saggi relativi a ordini da processare e messag- 
gi relativi a spedizioni da effettuare: in que- 



sto caso è opportuno creare due code diverse 
in cui recapitare i messaggi in modo da ren- 
dere totalmente indipendenti i messaggi, la 
loro spedizione, e soprattutto la loro ricezio- 
ne: l'applicazione o le applicazioni che devo- 
no analizzare il contenuto del messaggio 
apriranno la coda ordini se devono processa- 
re ordini o la coda spedizioni per analizzare 
le spedizioni da effettuare. Anche all'interno 
della stessa coda {Ordini ad esempio per tor- 
nare allo scenario di inizio articolo) potrem- 
mo però aver bisogno di differenziare fra 
ordini urgenti e ordini meno urgenti. La prio- 
rità è una delle proprietà impostabili sul sin- 
golo messaggio da spedire: è l'applicazione o 
le applicazioni sender che impostano tale 
proprietà; i messaggi nella coda di arrivo ver- 
ranno "scodati" (termine tecnico per indica- 
re il Receive del messaggio) in base a tale 
priorità. La proprietà è denominata Priority. 
È importante capire che la priorità non è 
assoluta: voglio dire che non è assolutamen- 
te certo che un messaggio a priorità bassa 
venga per forza di cose letto dopo un mes- 
saggio con priorità alta. Il motivo è semplice: 
se un'applicazione spedisce un messaggio a 
priorità bassa e subito dopo un messaggio a 
priorità alta e l'applicazione receiver è libera 
(e esiste connettività verso la coda) riceverà 
subito il messaggio a priorità bassa che verrà 
processato prima del messaggio successivo. 
Questo comportamento non rappresenta un 
problema e non deve rappresentarlo: se sem- 
bra un problema significa che non abbiamo 
inquadrato bene la problematica di lavoro 
asincrona. Prendiamo anche il caso in cui 
due Sender mandano nello stesso istante un 
messaggio a priorità alta e uno a priorità alta: 
se ad esempio il messaggio a priorità alta è 
più pesante (in termini di Kb) è probabile che 
raggiunga la coda di destinazione dopo il 
messaggio a priorità bassa. Ripeto: questo 
comportamento non è un problema e non 
deve esserlo. 



CONCLUSIONI 

Per questo primo articolo direi di fermarci: 
abbiamo cercato di chiarire con due esempi 
il ruolo di un sistema di messaggistica appli- 
cativa per poi vedere la forma più semplice di 
invio e ricezione di un messaggio. Abbiamo 
ancora molto da capire su MSMQ: metodi di 
delivery, garanzia di spedizione, transaziona- 
lità, journaling, administration queue, invio 
di classi custom all'interno dei messaggi. 

Roberto Brunetti 
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UN ASSO PER IL 
MULTIPIATTAFORMA 

CON LE LIBRERIE ACE È POSSIBILE REALIZZARE IN MANIERA ESTREMAMENTE SEMPLICE 
APPLICAZIONI CHE COMUNICANO VIA RETE. WINDOWS O LINUX NON FA DIFFERENZA! 
VEDREMO COME FARE TUTTO SENZA DIFFICOLTÀ 





□ CD □ WEB 

ACE.zip 



n 




REQUISITI 



■jj.i.wmiw.iujn 

, Basi di C++ 




Tempo di realizzazione 



O 



Spesso ci si trova di fronte alla necessità 
di dovere realizzare un'applicazione di 
rete in C/C++. Ci si pone di conseguenza 
la seguente domanda: "Sarà per Windows o per 
Linux?". Al contrario di altri linguaggi di pro- 
grammazione, come Java ad esempio, la scelta 
del sistema operativo è di cruciale importanza 
per definire quella che sarà la struttura del 
codice, oltre che il codice stesso. La comunica- 
zione di dati via rete, infatti, si basa moltissi- 
mo sulle funzioni messe a disposizione dal 
sistema operativo sottostante. Un programma, 
per quanto semplice, che debba avere le stes- 
se funzionalità su entrambe le piattaforme più 
diffuse, avrà per forza di cose codice diver- 
sissimo. Questa diversità tuttavia cozza un po' 
con quelli che sono i concetti di "riusabilità" e 
"generalità" che caratterizzano i software di 
buona fattura. Il concetto di "connessione 
TCP/IP", infatti, è unico e non ha senso distin- 
guere tra "connessione TCP/IP con Linux" e 
"connessione TCP /IP con Windows". La distin- 
zione è introdotta a livello pratico dalle intrin- 
seche differenze dei due sistemi. Sarebbe 
molto bello, in linea teorica, realizzare una li- 
breria generica che consenta, ad esempio, di 
utilizzare una ipotetica classe Connessione- 
TCPIP e lasciare ad essa il compito gravoso di 
gestire le chiamate di sistema giuste. Ancora 
più bello sarebbe trovare una libreria di questo 
tipo già fatta, di ottima qualità e semplice uti- 
lizzo! Nel prosieguo dell'articolo si parlerà di 
questa opportunità. 



COS'È ACE 

ACE sta per ADAPTIVE Communication Envi- 
ronment ed è un potentissimo insieme di libre- 
rie scritte in C++ per aiutare lo sviluppatore a 
scrivere facilmente applicazioni che siano: 

• portabili: le interfacce utilizzate sono le me- 



desime per ciascun sistema operativo. 
L'unica cosa da fare per un corretto porting 
è utilizzare la corretta libreria ACE sotto- 
stante; 

• dalle alte prestazioni: sono inclusi meccani- 
smi di ottimizzazione dell'utilizzo della me- 
moria. Ad esempio alcune classi permetto- 
no una gestione "interna" dei comandi 
"new" e "delete" in modo che l'allocazione 
sia fatta una sola volta e in quantità suffi- 
ciente , e non di volta in volta, con tutti i ral- 
lentamenti dovuti all'interazione col siste- 
ma operativo; 

• multithreading: è semplicissimo avviare un 
nuovo thread. Esistono molti modi tra i 
quali quello di istanziare un oggetto di una 
classe derivata da ACE_Thread e definire op- 
portunamente la funzione svc()', 

• per il networking: grazie all'infrastruttura 
fornita è davvero istantaneo instaurare con- 
nessioni di rete sia di tipo TCP che UDP. Un 
particolare occhio di riguardo è riservato 
alle prestazioni, che non sono assolutamen- 
te intaccate dall' utilizzo di ACE 

Insomma si tratta di uno strumento di sviluppo 
che qualsiasi programmatore dovrebbe impa- 
rare ad utilizzare in maniera costante, anziché 
reinventare ogni volta la ruota. ACE insomma 
non ha prezzo, e questo non è solo un apprez- 
zamento riguardo le sue straordinarie doti tec- 
niche, ma anche una constatazione del fatto 
che è completamente gratuito e libero da royal- 
ties di utilizzo! 



L'APPLICAZIONE 

Ci concentreremo in questo articolo sullo svi- 
luppo di una piccola applicazione client-server 
che dimostri le potenzialità di ACE in ambito di 
networking. Per mantenere il tutto il più sem- 
plice possibile creeremo un semplice echo-ser- 



► 84 /Aprile 2006 



http://www.ioprogrammo.it 



Networking multipiattaforma ■ T SISTEMA 



ver, ovvero un programma che svolge le se- 
guenti azioni: 

• si mette in ascolto su una porta per l'arrivo 
di un messaggio 

• quando il messaggio arriva, lo rimanda 
indietro identico (come l'eco...). 



ferma la sua elaborazione e attende delle ri- 
chiesta da parte di altri. Al contrario un pro- 
gramma di tipo client, come vedremo, inoltra 
attivamente delle richieste e si aspetta che il 
server le soddisfi nel più breve tempo possibile. 
Seguono delle dichiarazioni di costanti che uti- 
lizzeremo in seguito: 




Per concentrarci meglio sulle funzionalità di 
base offerte da ACE e sul suo meccanismo di 
comunicazione, tralasceremo intenzionalmen- 
te tutte le problematiche relative alla realizza- 
zione di un server "buono" dal punto di vista 
ingegneristico. In particolare il nostro server: 

• non gestirà connessioni multiple: potrà 
essere connesso ad un solo client per volta; 

• non effettuerà controlli sul tipo di dato rice- 
vuto: potrebbe quindi ricevere stringhe po- 
tenzialmente dannose. 

Al nostro server affiancheremo un'applicazione 
di tipo client, che non farà altro che mandare 
un messaggio al server e riceverne l'eco (cioè il 
messaggio così come è stato inviato). Si può be- 
nissimo capire come si tratti di esempi-giocat- 
tolo, che sono tuttavia validi dal punto di vista 
didattico. Vediamo dunque l'implementazione 
dei due programmi. 



IL SERVER 

Il codice del server viene riportato di seguito, 
commentato in tutte le sue parti. Innanzitutto è 
necessario includere gli header giusti, conte- 
nenti le classi che utilizzeremo di seguito: 

#include "ace/INET_Addr.h" 

#include "ace/SOCK_Stream.h" 
#include "ace/SOCK_Acceptor.h" 
#include <iostream> 

Il primo file contiene la dichiarazione di ACE_ 
INET_Addr, la classe utilizzata per le informa- 
zioni riguardanti un indirizzo IP, come ad 
esempio la porta, l'indirizzo vero e proprio ecc. 
SOCK_Stream.h contiene la dichiarazione di 
ACE_SOCK_Stream, l'oggetto che rappresenta 
un flusso di informazioni sul quale effettuare le 
operazioni di lettura/ scrittura dei dati che ven- 
gono ricevuti /inviati utilizzando la rete. SOCK_ 
Acceptor.h serve per potere utilizzare ACE_ 
SOCK_Acceptor, ovvero la classe che permette di 
istanziare oggetti che si "mettono in ascolto" 
sulla rete, in attesa di potere accettare delle ri- 
chieste. L'utilizzo di questa classe è peculiare di 
un programma di tipo server: tale programma 



#define MAXHOSTNAME 256 



#define BUFFERSIZE 1024 



#define PORT_NUMBER 12345 

A questo punto inizia il programma vero e pro- 
prio con la definizione della funzione mainQ: 



int main (int 


argc 


char* argv[]) 




{ 


ACE_ 


_INET_ 


Addr 


port_to_listen 


(PORT_NUMBER); 


ACE_ 


_SOCK 


_Acceptor acceptor; 





INSTALLARE E CONFIGURARE ACE 



I sorgenti Per la sua natura 
multipiattaforma ACE viene 
distribuito attraverso un 
pacchetto contenente i sorgenti 
del software. I sorgenti vanno 
compilati scegliendo l'oppor- 
tuna configurazione per il 
proprio sistema operativo. 
. Compilare sotto Windows 
Sono supportati moltissimi OS e 
compilatori. Ad esempio 
utilizzando Visual C++ 6.0 sotto 
Win32, scegliamo di compilare 
ACE come una DLL. Per fare 
questo apriamo il file 
ACE_wrappers\ace\ace_dll.dsw 



. Scegliere la configurazione 

Nella cartella ACE_wrappers\ace 
effettuiamo una copia del file 
conf ig-win32.h e la rinominiamo 
in config.h. Questo header 
contiene le opzioni giuste per 
generare la DLL. 
. Build. Torniamo all'interno del 
progetto aperto col Visual C++ e 
premiamo su "Build Ali". La 
compilazione richiede qualche 
minuto. Una procedura analoga 
è prevista anche per i sistemi 
Unix-like (ad es. Linux) e si basa 
sull'esecuzione di alcuni script 
Perl inclusi. 



Vengono istanziati due oggetti. Il primo, port_ 
tojisten, è un indirizzo di rete del tipo ACE_ 
INET_Addr visto in precedenza. Viene creato 
specificando unicamente il numero di porta, 
per cui si riferirà alla macchina locale (localho- 
st). Il secondo oggetto è di tipo ACE_SOCK_Ac- 
ceptor e sarà quello che materialmente si occu- 
perà di attendere una connessione in ingresso e 
di instaurarla quando sarà il caso. L'attesa di 
una connessione viene fatta occupando una 
porta libera del sistema operativo: 



if (acceptor. open (port_to_listen, 1) = = 


-1) 


{ 




std::cerr << "Non posso 


utilizzare la 


porta " 




<< PORT_NUMBER << 


"! Esco..." 




<< std::endl; 


return 1; 


} 



Con ACE questa cosa si fa utilizzando la funzione 
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open() dell'oggetto ACE_SOCK_Acceptor. La porta 
desiderata va specificata come primo argomento, 
tramite l'oggetto ACE_INET_Addr di prima. 
Qualora il risultato di questa funzione fosse -1 ci 
troveremmo in una situazione di errore. 
Tipicamente ciò avviene quando la porta è già 
utilizzata da un altro programma. Ad esempio 
lanciando due istanze del nostro server, la secon- 
da darà inevitabilmente un errore in questo 
punto. A questo punto comincia il lavoro vero e 
proprio del server, cioè l'attesa di una nuova con- 
nessione e la successiva gestione della stessa: 

int cont = 1; 

std::cerr << "[" << cont << "] In attesa di una 

connessione..." << std::endl; 



while (1) 



{ 



ACE_SOCK_Stream peer; 



ACE_INET_Addr peer_addr; 



ACE_Time_Value timeout (10, 0); 



if (acceptor.accept (peer, &peer_addr, &timeout, 

0) ==-1) 



{ 



std::cerr << "[" << ++cont << "] In attesa 
di una connessione..." << std::endl; 



> 



All'interno di un ciclo infinito ( while(l) {...}) 
viene istanziato l'oggetto peer di tipo ACE_ 
SOCK_Stream. Su questo oggetto verranno ef- 
fettuate le operazioni di invio e ricezione dati. 
Viene creato inoltre un altro oggetto di tipo 
ACE_INET_Addr, che conterrà l'indirizzo del 
client remoto e la porta sul quale la connes- 
sione viene gestita. L'oggetto timeout è di tipo 
ACE_Time_Value e serve a far sì che la succes- 
siva chiamata 

acceptor.accept() 

abbia una "scadenza" dopo un certo periodo di 
tempo, in questo caso 10 secondi. Questo è 
necessario poiché la acceptQ è di tipo bloccan- 
te, cioè ferma l'esecuzione dell'intero pro- 
gramma fino a quando non viene istaurata una 
connessione. Questo comportamento di solito 
non è voluto in un server, ecco perché dopo la 
scadenza del timeout viene stampato un mes- 
saggio con un numero progressivo, ad indicare 
che il programma è "vivo". Successivamente 
viene eseguito un nuovo ciclo di attesa di una 
connessione. Quando la connessione ha suc- 
cesso viene gestita dal seguente codice: 

else 
{ 

ACE_TCHAR peer_name[MAXHOSTNAME]; 



peer_addr.addr_to_string (peer_name, 

MAXHOSTNAME); 

std::cout << "Connessione avvenuta con " 

<< peer_name << std::endl; 

char buffer[BUFFERSIZE]; 

ssize_t bytes_received; 

while ((bytes_received = peer.recv (buffer, 

sizeof(buffer))) != -1) 



{ 



std::cout << "[" << cont++ << "] 

RICEVO: " << buffer << std::endl; 
peer.send_n (buffer, bytes_received); 



} 



peer.closeQ; 



> 



return 0; 



} 



Le prime tre righe del ramo "else " non fanno 
altro che stampare a schermo l'indirizzo re- 
moto col quale si effettua la connessione non- 
ché la porta sulla quale le connessione è gesti- 
ta (tale porta è normalmente diversa dalla 
porta di attesa della connessione). L'indirizzo 
viene ricavato semplicemente utilizzando la 
funzione addr_to_string() che restituisce una 
stringa nel formato: 

INDIRIZZO:PORTA 

Nel successivo ciclo while avvengono le opera- 
zioni di ricezione e invio dei dati. La ricezione 
è effettuata dall'istruzione recvQ all'interno 
della condizione del while stesso. L'invio di ciò 
che è stato ricevuto avviene con la send_n(), 
nella quale specifichiamo il buffer da inviare e 
il numero di byte di cui esso è composto. Sia 
recvQ che send_n() vengono richiamate, come 
già anticipato, sull'oggetto peer di tipo ACE_ 
SOCK_ Stream. Possiamo provare subito il ser- 
ver effettuando una connessione telnet sulla 
porta 12345. Scriviamo ad esempio: 

telnet localhost 12345 

dopo avere lanciato l'eseguibile del server. 
A questo punto tutto ciò che scriviamo do- 
vrebbe essere stampato 2 volte: 1 è il carattere 
scritto e 1 quello ricevuto dall' echo- server: 

iiooPPrrooggrraammmmoo ccoonn ACCEE 



IL CLIENT 

Il codice del client è più semplice di quello del 
server. Il suo compito è quello di connettersi 
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al server sulla macchina locale alla porta co- 
nosciuta e inviare un messaggio con una ca- 
denza regolare di 1 secondo tra un invio e l'al- 
tro. Il client stampa inoltre quello che riceve 
dal server. 
Vediamo insieme il codice: 

#include "ace/INET_Addr.h" 

#include "ace/SOCK_Stream.h" 
#include "ace/SOCK_Connector.h" 



#include <iostream> 



#define PORT_NUMBER 12345 



#define MAXBUFSIZE 256 



#define MESSAGE "Ciao! Sono il client..." 



int main (int argc, char* argv[]) 



{ 



ACE_INET_Addr server (PORT_NUMBER, 

ACE_LOCALHOST); 



ACE_SOCK_Connector connector; 



ACE_SOCK_Stream peer; 

Inizialmente troviamo le consuete inclusioni 
analoghe al codice del server. Nella funzione 
mainO • Vengono istanziati tre oggetti ACE. 
L'utilizzo dell ì ACE_SOCK_Stream è identico a 
quello visto in precedenza: serve per le opera- 
zioni di lettura/ scrittura. L'indirizzo contenu- 
to nella variabile "server" indica l'IP della 
macchina su cui il server risiede, in questo 
caso la macchina locale. A differenza del codi- 
ce del server, per stabilire la connessione di 
rete, non troviamo un oggetto di tipo "accep- 
tor" bensì uno di tipo "connector": 



std::cout << ' 


Cerco di connettermi 


al server sulla 

porta " 


<< PORT_NUMBER 


<< std: 


endl; 


if ( co n necton co nnect (peer, 


server) 


= =-1) 


{ 


std::cerr << 


"Impossibile 


connettersi al server!" 

<< std::endl; 


return 1; 


} 


else 


{ 


std::cout << 


"Connesso!" 


<< std 


:endl; 


} 



il connector cerca di stabilire la connessione, 
se non ci riesce (ad es. perché il server non è 
stato lanciato) restituisce subito un risultato 
di errore, senza ulteriori attese. In altre parole 
non c'è bisogno di prevedere l'utilizzo di un 
timeout, poiché si chiede attivamente una 
connessione, e non si deve restare in attesa di 
nulla. Per instaurare la connessione si utilizza 
la funzione connectQ. 



Come nel caso del server, anche per il client è 
previsto un ciclo while infinito che periodica- 
mente invia un messaggio predefinito: 

int bc, cont = 0; 

char buf[MAXBUFSIZE]; 

char message[] = MESSAGE; 



while (1) 



{ 



std::cout << "[" << ++cont << "] "; 
std::cout << "INVIO: " << message 



<< std::endl; 



peer.send_n (message, sizeof(message)); 



bc = peer.recv (buf, sizeof(buf)); 



std::cout << "[" << cont << "] 



std::cout << "RICEVO: " << buf << std::endl; 



ACE_OS::sleep(l); 



} 



peer.close (); 



return (0); 



} 



Le operazioni di invio /ricezione dati vengono 
effettuate, come visto in precedenza, attraverso 
le recvQ e send_n(). Da notare come l'attesa del 
tempo prestabilito avvenga utilizzando la fun- 
zione ACE 

ACE_OS::sleep(l); 

che generalizza le varie funzioni di attesa pre- 
senti nei diversi sistemi operativi. Questa è solo 
una delle tante utilità offerte dalla libreria ACE, 
che permettono di scrivere codice altamente 
portabile. 

Come ultima cosa segnaliamo il fatto che, in ge- 
nere, ogni flusso dati che si crea dovrebbe es- 
sere opportunamente chiuso, al termine del 
suo utilizzo mediante la closeQ. 



CONCLUSIONI 

In questo articolo abbiamo illustrato solo la 
punta dell'iceberg di quell'insieme di librerie 
software che è racchiuso sotto il nome ACE. 
Sottolineiamo come queste librerie non solo of- 
frano l'infrastruttura per scrivere un codice al- 
tamente portabile, utilizzabile sotto una grande 
varietà di sistemi operativi, ma consentano 
anche di fare le comuni operazioni di sistema in 
maniera molto più semplice del solito, senza 
alcuna perdita in termini di efficienza. Ci sen- 
tiamo insomma di raccomandare lo studio e 
l'utilizzo regolare di queste librerie, così come 
facemmo, su queste stesse pagine, nel caso del- 
le STL. 

Alfredo Marroccelli 
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Qualche numero fa di ioProgrammo ci siamo 
occupati della realizzazione di interfacce 
grafiche tramite le librerie wxWidgets. 
Riassumiamo brevemente qualche concetto base. 
WxWidgets (anche conosciuta come wxWindows) è 
un framework open source per la realizzazione di 
interfacce utente cross-platform con aspetto nativo. 
Praticamente wxWidgets è un insieme di librerie che 
permette di realizzare applicazioni C++ in grado di 
essere compilate ed eseguite su un gran numero di 
piattaforme. Questo è possibile poiché sono dispo- 
nibili tante versioni delle librerie per quante sono le 
piattaforme supportate. Le piattaforme grafiche 
attualmente supportate sono Windows, GTK+, 
Motif, e Mac. wxWidgets non copre solo gli aspetti 
relativi all'interfaccia grafica ma copre anche pro- 
blematiche inerenti la gestione del file system, i ser- 
vizi di rete, il multithreading ed il 3D tramite 
OpenGL. Gli strumenti necessari per utilizzare wx- 
Widgets sono un compilatore C++ e la libreria stessa. 
Inizializzare una form con le wxwigets è quanto di 
più semplice al mondo: l'intera applicazione viene 
gestita da un oggetto di tipo wxApp. La classe wxApp 
è astratta e bisogna ridefinire due metodi Onlnit e 
OnExit. 

class myApp : public wxApp 
{ public: 

bool OnlnitQ; 



SetTopWindow(myWin); 



int OnExitQ; 



}; 



quando andiamo ad implementare la classe myApp 
dobbiamo inserire la seguente riga : 

IMPLEMENT_APP( myApp ) 

Poi andiamo a definire le funzioni. 

bool myApp: :OnInit() 
{ wxFrame *myWin = 
new wxFrame(NULL,-l, 
"Hello wxWorld"); 



myWin->Show(TRUE); 



return TRUE; } 



int myApp: :OnExit(){ return 0; } 

A myWin possono poi essere aggiunti dei controlli, 
ad esempio: 

wxBoxSizer* box = 

new wxBoxSizer(wxHORIZONTAL); 

box->Add( new wxTextCtrl(myWin, ID_TEXTBOX , 

"Testo", wxPoint(0,0),wxSize(100,20) ), 

Q,wxALIGN_CENTER_VERTICAL | wxALL, 5); 

box->Add( new wxButton( myWin, ID_BOTTONE, 

"Bottone", wxPoint(0,0),wxSize(80, 20) ), 

Q,wxALIGN_CENTER_VERTICAL | wxALL,5); 

myWin->SetSizer(box); 

e infine possiamo gestire gli eventi 

class myFrame : public wxFrame 
{ public: 

myFrame( wxWindow * parent, 

int id, const wxString &title); 
void OnTextChange(wxCommandEvent &event ); 
void OnPressButton(wxCommandEvent &event ); 
private: 
DECLARE_EVENT_TABLE() 

}; 



Per ragioni di spazio non possiamo riassumere oltre 
quanto già detto nei numeri precedenti. In questo 
articolo ci occuperemo di alcun aspetti avanzati. 



FILES E DIRECTORY 

Immaginiamo per prima cosa di voler ottenere tutti 
i file e le directory contenute in percorso generico. 
L'espressione del percorso di ricerca dipende dalla 
piattaforma di esecuzione dell'applicazione finale. 
wxWidgets, comunque, riesce ad utilizzare il forma- 
to dei percorsi tipico di unix anche sotto altre piat- 
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taforme, senza dovere proteggere i percorsi con lun- 
ghe sequenze di escape. 

#include <wx/dir.h> 

wxDir dir( percorso ); 

if ( !dir.IsOpened() ) 

{ wxMessageBox("II percorso non esiste"); 



return; } 



wxString filename; 



bool continua = dir.GetFirst(&filename, "*.*" ); 



while ( continua ) 



{ //operazioni con filename 



continua = dir.GetNext(&filename); 



> 



La funzione GetFirst restituisce, attraverso il punta- 
tore alla stringa filename, il nome del primo file che 
rispecchia la stringa di ricerca passatagli come 
secondo argomento. Se nessun file è stato trovato il 
valore restituito è false, altrimenti è true e la ricerca 
continua. I file successivi vengono restituiti dalla 
funzione GetNext. Per ottenere informazioni su i file 
trovati con il metodo appena illustrato possiamo 
utilizzare la classe wxFileName.Essa espone alcuni 
metodi per maneggiare file e directory, andiamo a 
vederne alcuni. 

#include <wx/filename.h> 

wxFileName fname( filename ); 

if( marne. IsDir() ) return; 

wxString path = marne. GetFullPath(); 

wxString name = marne. GetName(); 

wxString fullname = marne. GetFullName(); 

Dopo aver istanziato un nuovo oggetto di tipo wxFi- 
leName, andiamo a controllare se siamo in presenza 
di una directory. Possiamo inoltre ottenere il percor- 
so completo del file, oppure il nome completo di 
estensione. È importante specificare che i metodi su 
citati non verificano l'esistenza fisica del file. Per 
verificare che i file esistano fisicamente bisogna uti- 
lizzare le funzioni statiche 
wxFilename::DirExists(path) oppure wxFilename:: 
FileExists(path). Per creare una nuova directory pos- 
siamo utilizzare il metodo Mkdir(). 



che 


r data [2] = 


{ OxFF, OxCO }; 


file 


Write( data 


,2); 


file 


Close(); 




} 



Inserire testo o dati binari è molto semplice. L'unica 
accortezza che dobbiamo avere è quella di chiudere 
il file dopo l'utilizzo. Ora andiamo a vedere come 
leggere i dati da un file 



wxFile fileb( "prova.txt", wxFile::read); 

if( fileb.IsOpenedQ ) 

{ char buffer [ 512 ]; 



while( !fileb.Eof() ) 



{ size_t cnt = fileb.Read(buffer, 511); 



buffer[cnt]= 0; 



printf( buffer ); } 



fileb.Close(); 



> 



Se osserviamo la modalità di lettura dei dati ci accor- 
giamo che la classe wxFile non è altro che un wrap- 
per intorno ai descrittori di file dello stdio. Se abbia- 
mo bisogno di lavorare con file bufferizzati possia- 
mo utilizzare la classe wrapper della struttura FILE 
wxFFile. La classe wxFile si utilizza allo stesso modo 
di wxFile. L'unica differenza è la forma di inizializza- 
zione. Infatti al posto di wxFile::read o wxFile::open 
bisogna usare "r" o "w" o comunque le stringhe di 
inizializzazione delle funzioni fopen dello standard 
e. wxWidget mette a disposizione anche gli stream. 
La gestione degli stream è molto simile alla tradizio- 
nale versione del c++ ma con una serie di funziona- 
lità aggiuntive molto utili. Una su tutte è la possibi- 
lità di incapsulare tra loro gli stream. Ad esempio 
creiamo uno stream per la gestione della gestione 
della scrittura su file: 

wxFFileOutputStream output("mytext.txt"); 

A questo punto potremmo decidere di scrivere sul 
file nello stile di C++ ed in particolare nel modo in 
cui scriviamo su cout. Andiamo a creare un nuovo 
stream che incapsula il precedente e che ci fornisce 
questa funzionalità: 




Uno dei problemi 
ricorrenti delle 
applicazioni cross- 
platform è la gestione 
dei percorsi. 
È importante, quindi, 
utilizzare il meno 
possibile all'interno 
del nostro codice 
riferimenti a file. 



LEGGERE E SCRIVERE 
UN FILE 

Andiamo ora a vedere come scrivere un file in wx- 
Widget. 



wxFile file( " 


prova.txt" 


, wxFile:: 


write); 


if( file.IsOpened() ) 


{ file.Write( 


"Testo di | 


Drova\n") 


/ 


file.WriteC 


Linea une 


\n"); 




file.Write(' 


Linea due 


\n"); 





wxTextOutputStream cout( output ); 

A questo punto siamo pronti per scrivere sullo 
stream. 



if( output.Ok() ) 


{ cout << "Testo 


' << endl; 




cout << 1234 


<< endl; 




cout << 1.23456 << endl; 


} 


output. CloseQ; 



dopo aver controllato lo stato dello stream andiamo 



http://www.ioprogrammo.it 



Aprile 2006/ 89 ► 



SISTEMA 



Caratteristiche avanzate delle wxWidgets 





APPROFONDIMENTI 



CROSS 
-PLATFORM 

Con il termine cross- 

platform vengono 

indicati i progetti che 

possono essere 

ricompilati sotto 

piattaforme differenti. 

Scrivere codice 

completamente 

portabile è molto 

complicato poiché ogni 

sistema operativo 

mette a disposizione 

strumenti per lo 

sviluppo differenti 

(Win32, gtk, kde, ...). 

Anche la struttura e la 

dimensione dei tipi di 

base può cambiare tra 

compilatori diversi . 

wxWidgets ci viene 

incontro mettendoci a 

disposizione tutti gli 

oggetti e gli strumenti 

considerati "critici" 

evitandoci fastidiosi 



a scrivere alcuni dati ed infine chiudamo l'accesso al 
file. Chiudendo lo stream più in alto verranno chiu- 
si automaticamente tutti gli stream sottostanti. Nel 
codice seguente andiamo a leggere i dati appena 
scritti. 

wxFilelnputStream input( "mytext.txt" ); 
wxTextlnputStream text( input ); 
int il; 



wxInitAIIImageHandlersO; 



float f2; 



wxString line; 



if( input.OkQ ) 



{ text >> line; 



text >> il; 



text >> f2; 



> 



Gli stream di input non necessitano della chiusura. 
Per la lista completa degli stream è bene consultare 
la documentazione allegata alla libreria. 



UTILIZZARE LE IMMAGINI 

Cambiamo decisamente discorso. Ora, ci occupere- 
mo della gestione delle immagini attraverso 
wxWidgets. Vedremo come caricare, manipolare e 
salvare i file di immagine. Il caricamento e il salva- 
taggio delle immagini è affidato ad una serie di clas- 
si chiamate Image Handlers. Ogni handler si occupa 
di un formato particolare. Possiamo decidere di cari- 
care un handler in particolare, una serie, oppure 
tutti quelli disponibili. Per poterne caricare uno 
basta richiamare la funzione statica 
wxImage::AddHandler(). Di seguito viene riportato 
l'elenco completo degli handler disponibili. 

wxBMPHandler 

wxPNGHandler 

wxJPEGHandler 

wxGIFHandler 

wxPCXHandler 

wxPNMHandler 

wxTIFFHandler 

wxIFFHandler 

wxXPMHandler 

wxICOHandler 
wxCURHandler 
wxANIHandler 



Tutti gli handler permettono di caricare e salvare le 
immagini del formato corrispondente fatta, a ecce- 
zione del formato GIF, IFF e ANI. Il wxBMPHandler 
è sempre caricato e wxPNGHandler supporta le tra- 
sparenze attraverso il canale alpha. Per caricare tutti 
gli handler in un colpo solo possiamo utilizzare il 
metodo wxInitAIIImageHandlersO. Ora la compren- 
sione del codice seguente diventa banale. 



wxlmage image; 



if(image.LoadFile( "image.jpg" ) ) 



{ int w = image. GetWidthQ; 



nt h = image. GetHeightQ; 



mage.Rescale( w/2 , h/2); 



mage = image. Mirror(); 



image. Replace( 0x00, 0x00, 0x00, 0x00,0xFF,0x00 ); 



image. SaveFile("image.png",wxBITMAP_TYPE_PNG ); 



} 



Dopo aver inizializzato tutti gli handler a disposizio- 
ne proviamo ad aprire un file con la funzione Load- 
File. Se tutto è andato bene andiamo ad ottenere le 
dimensioni dell'immagine. Poi possiamo compiere 
alcune operazioni sull'oggetto image come la risca- 
latura, il ribaltamento, e la sostituzione del colore 
nero( 0x000000) con il verde ( OxOOFFOO); poi sce- 
gliamo il file di salvataggio e salviamo il lavoro come 
file PNG. La funzione SaveFile ci mette a disposizio- 
ne due modi di scegliere il formato di salvataggi. Il 
primo prevede l'identificazione del formato dall'e- 
stensione del nome del file (questo metodo risulta 
efficace quando si utilizzano le estensioni standard) 
oppure tramite il passaggio di un parametro che 
identifica il formato; in questo caso è possibile sce- 
gliere un'estensione del file non standard. Le 
costanti che identificano i formati delle immagini 
sono le seguenti : 



wxBITMAP. 


_TYPE_ 


_BMP 


wxBITMAP. 


_TYPE_ 


_PNG wxBITMAP_TYPE_JPEG 


wxBITMAP. 


_TYPE_ 


_PCX 


wxBITMAP. 


_TYPE_ 


_PNM 


wxBITMAP. 


_TYPE_ 


_TIFF 


wxBITMAP. 


_TYPE_ 


_XPM 


wxBITMAP. 


_TYPE_ 


_CUR 


wxBITMAP. 


_TYPE_ 


_ICO 



queste costanti sono utilizzabili anche con il meto- 
do LoadFile per forzare il riconoscimento del tipo di 
file. 



I DEVICE COIUTEXT 

I device Context (DC) rappresentano una serie di 
classi che possono essere utilizzate per le operazioni 
di disegno su una periferica supportata. Attraverso i 
DC è possibile disegnare sullo schermo intero, su 
una finestra, sulla stampante, su un file immagine o 
su un documento PostScript utilizzando sempre la 
stessa sintassi. Infatti tutti i device contex citati ere- 
ditano dalla classe wxDC. Va ricordato che anche in 
questo caso il codice scritto è valido su tutte le piat- 
taforme supportate da wxWidgets. Nell'esempio 
seguente realizzeremo un'immagine da zero e poi la 
salveremo come un file png. 
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wxBitmap bmp( 200, 200 ); 



if (wxTheClipboard->Open()) 



wxMemoryDC de; 



{ wxTheClipboard->SetData 



dc.SelectObject( bmp ); 

Istanziamo un oggetto di tipo wxBitmap e diamogli 

la dimensione qua- 
drata 200x200. Poi 
Realizziamo un DC 
virtuale in memoria 
e gli associamo la 
bitmap. Poi trattia- 
mo la variabile de 
come un DC tradi- 
zionale e procedia- 
mo con le operazioni 
di disegno. 



(new wxBitmapDataObject(bitmap)); 



IO PROGRAMMO 








( | 






z 


/ 


<^F 





Fig. 1: II risultato dell'uso di 
una wxBitmap 



dc.SetBackground( *wxWHITE_BRUSH ); 

dc.ClearQ; 

dc.DrawText(_T("IO PROGRAMMO"), 10, 10 ); 

dc.SetPen( *wxBLACK_PEN); 

dc.SetBrush( *wxGREEN_BRUSH ); 

dc.DrawRectangle( 60, 80 , 65 , 55 ); 

dc.SetBrush( *wxCYAN_BRUSH ); 

dc.DrawRectangle( 93, 47 , 66 , 66 ); 

dc.SetBrush( *wxRED_BRUSH ); 

dc.DrawEllipse( 100, 100 , 50 , 50 ); 

dc.Drawl_ine( 200, 0,0, 200 ); 
dc.SelectObject( wxNullBitmap ); 
bmp.SaveFile("image.png", wxBITMAP_TYPE_PNG); 



Il risultato di queste operazioni è visibile nella 
Figurai. 



GESTIONE 
DEGLI APPUNTI 

Una delle funzionalità più utili, che un programma 
possa mettere a disposizione, è senza dubbio la ge- 
stione degli appunti o clipboard. Per capirci meglio 
la possibilità di utilizzare il taglia, copia e incolla. 
WxWidgets si occupa di fornire al programmatore 
una semplice soluzione per l'utilizzo di questa carat- 
teristica sempre in modo cross-platform. Questo 
viene fatto mettendo a disposizione un oggetto glo- 
bale wxTheClipboard disponibile inserendo la diret- 
tiva #include <wx/clipbrd.h>. Per utilizzare la clip- 
board bisogna innanzitutto ottenerne il possesso 
attraverso il metodo Open poi possiamo utilizzarla. 
Vediamo ora come inserire del testo negli appunti. 

if (wxTheClipboard->Open()) 
{ wxTheClipboard->SetData 

(new wxTextDataObject("Testo Salvato")); 

wxTheClipboard->Close(); } 



wxTheClipboard- >Close(); 



} 



Per leggere il testo degli appunti dobbiamo ottenere 
l'escusiva sulla clipboard controllare se i dati in me- 
moria sono di tipo testuale e poi procedere con l'e- 
strazione... 

if (wxTheClipboard->Open()) 

{if 

(wxTheClipboard->IsSupported(wxDF_TEXT)) 
{ wxTextDataObject data; 

wxTheClipboard->GetData( data ); 

wxMessageBox( data.GetText() ); } 
wxTheClipboard- >Close(); 



Anche questa operazione è molto semplice da rea- 
lizzare ma allo stesso tempo molto utile. 



USARE I WXSOCKET 

Tra le tante classi troviamo anche il supporto ai soc- 
ket. In wxWidget, a differenza degli strumenti pro- 
posti nativamente dai sistemi operativi, è molto 
semplice operare con questi costrutti. A nostra di- 
sposizione vengono messe a disposizione due classi 
wxSocketServer e wxSocketClient. La prima si occu- 
pa di creare un servizio e mettersi in ascolto su una 
porta la seconda invece ci semplifica la vita qualora 
noi volessimo connetterci ad un servizio in ascolto 
su una porta. Per creare un servizio bisogna innan- 
zitutto definire la porta; questo viene fatto attraver- 
so la classe wxIPV4address che definisce gli indirizzi 
attraverso il protocollo IPV4, poi scegliamo la porta 
del servizio stesso. 

wxIPV4address addr; 
addr.Service(3000); 

Il codice appena visto corrisponde all'indirizzo "lo- 
calhost:3000". ora siamo pronti per creare il servizio 

wxSocketServer * m_server = new wxSocketServer(addr); 

A questo punto abbiamo creato il socket client e 
dobbiamo metterlo in ascolto. Avviamo il servizio in 
modo sincrono, ovvero il socket bloccherà l'esecu- 
zione del programma sino alla prima richiesta di 
connessione 

wxSocketBase * client = m_server->Accept(true); 





SUL WEB 



Il progetto wxWidgets 
è disponibile 
all'indirizzo 

http://www.wxwidgets.org 

Tutte le informazioni su 
wxDevCpp sono 
reperibili al seguente 
indirizzo. 

http://wxdsgn.sourceforge 
.net/ 



possiamo anche salvare un'immagine... 



Appena sarà disponibile una richiesta, la variabile 
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wxDevcpp installa una 

serie di packages 

predefiniti tra i quali 

wxWidgets 2.6.1 

completo di guida in 

linea. 



client punterà ad un'oggetto di tipo wxSocketBase 
se nessuna richiesta giungerà al servizio per una 
durata di 10 minuti (timeout) la funzione AcceptO 
restituirà il valore NULL. Il valore true passato alla 
funzione AcceptO indica che tale funzione aspetterà 
la durata del timeout o l'arrivo di una richiesta di 
connessione prima di restituire un valore. Per varia- 
re il tempo di timeout possiamo utilizzare la funzio- 
ne SetTimeout(int seconds) quindi selezionare il 
nuovo tempo massimo di attesa. Possiamo evitare lo 
stallo del programma ed utilizzare la versione non 
bloccante di AcceptO. 

wxSocketBase * client = NULL; 

while( client == NULL ) 

{ //... Fai altre operazioni 



client = m_server->Accept(false); 



> 



Una volta ottenuto un client in connessione possia- 
mo procedere con la comunicazione. Definiamo un 
piccolo protocollo di comunicazione per ricevere 
stringhe di testo. Il cliente appena collegato invia al 
server un comando che identifica l'operazione da 
compiere. Il comando viene inviato con un char, ed 
in particolare decidiamo di inviare OxBE. A questo 
punto andiamo ad aspettare la definizione della lun- 
ghezza della stringa. Ipotizziamo che le stringhe sia- 
no lunghe al massimo 255 caratteri quindi utilizzia- 
mo un unsigned char per ricevere la dimensione del 
testo, prepariamo un buffer per ricevere i dati e rice- 
viamo la stringa. A questo punto inviamo la stringa 
ricevuta al mittente come test. 



unsigned 


char e; 


client->l 


*ead(&c, 1); 


if( e = = 


OxBE ) 


{ unsigned char len; 


char * 


buf; 


client- 


>Read(&len,l); 


buf = 


new char[len]; 


client- 


>Read(buf, len); 


client- 


>Write(buf, len); 


delete[] buf; } 


else 


{ printf( 


"Comando errato");} 


delete m. 


_server; 



Per interrompere il servizio basta eliminare l'ogget- 
to che lo realizza, nel nostro caso m_server. 
Andiamo ora a realizzare il client. Il codice del client 
va scritto e compilato in progetto differente dal codi- 
ce del server. Inoltre, è semplice intuirlo, il client può 
girare anche su una macchina differente da quella in 
cui viene eseguito il server. Prepariamo l'indirizzo : 

wxIPV4address addr; 

addr.Hostname("127.0.0.r'); 

addr.Service(3000); 

Scegliamo come indirizzo IP il localhost e come 
porta la 3000, ovvero scegliamo l'indirizzo e la porta 
del servizio creato in precedenza, poi proviamo a 
stabilire una connessione: 

wxSocketClient * m_sock = new wxSocketClient(); 
client->Connect(addr, false); 



IL MIO PRIMO PROGETTO CON WXDEVCPP 

Vedremo in sei semplici passi come sfruttare un DEVC++ come IDE RAD per lo sviluppo di interfacce grafiche. 
Scopriremo che il m eccanismo è identico a quello degli IDE più evoluti 



> UN NUOVO PROGETTO 




m # e a Lj 



C4** ItfWllMP m 



I *m \ ~à**è*\ ?#to | 



I Una volta eseguito wxDevcpp sele- 
I zioniamo dal menu File la voce Nuo- 
vo->Progetto. Dalla sezione basic sceglia- 
mo di creare un progetto dal template 
"wxWidgets Dialogs" inseriamo un nome 
per il nostro lavoro e diamo l'ok! 



> QUALI CLASSI? 





Class Nanne 
File nanne 
Save To 
Title 
Author 

Default S^le 




sion) 


settoProva 


ProgettoProva (WithoutExten 


DAS teranc < ograrmrma\ 


IN 


wxWidgets Intro 


1 


Stefano Ve^a 


1 


Use Caption Q Resize Border System Menu 
□ ThickBorder □ S tay n T op N o Parent 
Min Button □ Max Button Close Button 






Create 


Cancel 









Il prossimo passaggio è definire il no- 
I me dei file e delle classi che compon- 
gono il progetto di base. La procedura è gui- 
data. Una volta completate le procedure di 
configurazione siamo pronti per iniziare a 
lavorare. 



> I FILE DELLE FORM 




I 



Progetto Classi Debug 
,l^ Progetto! 



wxDevcpp salva le informazioni sui 
dialoghi grafici in file di estensione 
wxform. È sufficiente andare nel visualizza- 
tore dei file del progetto e selezionare i fi- 
le con tale estensione per accedere all'edi- 
tor di dialoghi. 
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bool aspetta = true; 



while( !client->WaitOnConnect(10,0) && aspetta ) 
{ //..possiamo dare informazioni 

//all'utente oppure aggiornare lo 

//stato di aspetta} 
bool ok = client->IsConnected(); 



Se tutto è andato a buon fine e il flag ok è vero, pos- 
siamo iniziare il dialogo con il servizio. 

if(ok) 

{ const wxChar *bufl; 



wxChar 



*buf2; 



unsigned char len; 



unsigned char e = OxBE; 



client- >Write(&c, 1); 



bufi = _("Testo di prova più corto di 256 caratteri!)"); 



len = (unsigned char) 



(wxStrlen(bufl) + l)*sizeof( wxChar)); 
buf2 = new wxChar[wxStrlen(bufl) + 1]; 
printf("Inviamo il testo al server... \n"); 
client- >Write(&len, 1); 
client->Write(bufl, len); 

printf( client- >Error() ? "Errore!\n" : "Fatto\n" ); 
printf("Riceviamo la risposta dal server ..."); 
client->Read(buf2, len); 

printf( client->Error() ? "Errore!\n" : "Fatto\n" ); 
printf(_("Compariamo i buffer...")); 
if (memcmp(bufl, buf2, len) != 0) 
{ printf("Errore nella comunicazione!\n");> 
else 

{ printf("Comunicazione andata a buon fine!\n");> 
delete[] buf2; } 



Purtroppo non ci sono modi di controllare se i dati 
inviati corrispondono alla dimensione attesa. Nel 
caso in cui i dati inviati risultino essere minori di 
quelli attesi è possibile che si verifichino errori di 
overflow mentre nel caso in cui la dimensione dei 
dati comunicata sia inferiore di quella effettivamen- 
te inviata, i dati ricevuti saranno errati. 



GESTIONE DEI THREAD 

Una aspetto della programmazione che non poteva 
mancare in questo pacchetto è la gestione dei 
thread. In wxWidgets la gestione dei thread o pro- 
cessi leggeri è realizzata utilizzando il paradigma 
della programmazione ad oggetti. Infatti la libreria 
mette a disposizione una classe astratta, wxThread, 
dalla quale ereditare le classi che contengono il co- 
dice da eseguire all'interno di un thread secondario. 
Sono messi a disposizione dello sviluppatore anche 
una serie di oggetti che riguardano la programma- 
zione concorrente in generale. Questi oggetti sono 
wxMutex e wxCriticalSection per gestire la mutua 
esclusione, wxCondition per implementare mecca- 
nismi di sincronizzazione mediante eventi, wxSe- 
maphore per la sincronizzazione attraverso il para- 
digma dei semafori. Per prima cosa vediamo come 
avviare un nuovo thread. La prima cosa da fare è 
usare la direttiva "#include <wx/thread.h>" succes- 
sivamente è possibile creare la classe che incorpora 
il thread. Come esempio vediamo la realizzazione di 
un thread che scrive su di una textbox in modo asin- 
crono al flusso principale della nostra applicazione. 




C++ 




APPROFONDIMENTI 



THREADIMG 

Il multithreading è una 
caratteristica dei siste- 
mi operativi molto in- 
teressante. Ma essere 
in grado di far girare il 
codice in modo paralle- 
lo è allo stesso tempo 
affascinante e pericolo- 
so. Non accade così di 
rado che un'applicazio- 
ne vada in stallo per 
una gestione scorretta 
della sincronia tra 
thread differenti. A 
volte l'intero sistema si 
blocca. Per fortuna 
wxWidget ci viene in- 
contro con una serie di 
strumenti molto utili. 
Ma la riuscita di una 
applicazione dipende 
sempre dalla accuratez- 
za impiegata dallo svi- 
luppatore durante la 
realizzazzione. 



> DISEGNIAMO 



> DOVE SONO I CONTROLLI ? > LE PROPRIETÀ 




In questa modalità è possibile inseri- 
I re nel dialogo tutti gli oggetti messi 
a disposizione dal framework. Lo stile è quel- 
lo classico degli editor RAD, è sufficiente tra- 
scinare il controllo desiderato sulla form per 
ottenerne una riproduzione fedele 



LVb hnestra Help 


itt m 


E3r E3 S5 


► m&n 




aTitololFrm.cpp [*] SenzaT < ► 


Controls 


* 




: 'SS^H^H 


*> 







A StaticText 







foìTl Button 


'.* WxButtonl JH 


|T1 BitmapButton 




alili Edit 








m\ Menno 








jx CheckBox 




1 




(i RadioButton 



I Tutti i controlli (e non solo) inseribili 
I nei frame sono elencati nella barra a de- 
stra dell' IDE. E' possibile scegliere fra bot- 
toni, label, combo, tutti i classici controlli di- 
sponibili, ovviamente wxWidgets funzionerà 
sia su sistemi Windows che Linux 





WxButtonl :wxButton 


w 


Properties Events 




Background Color 


Edit Color * | 


Base Class 
Border 
E Button Style 


wxButton 
5 




[] 


Default 


False 


Font 


Edit Font 


Foreground Color 
General Styles 


Edit Color 


[] 




Height 


41 




HelpText 






Hidden 


False 




HorizontalAlignment 


wxSZALIGN CENTER H0RIZ0NTAL 




IDName 
o,JJ Compilatore =f] R 


ID WXBUTT0N1 


T 


Eione f§ Debug 





Per ogni controllo selezionato è possibile 
modificarne i parametri attraverso l'u- 
tile editor di proprietà in stile VisualStudio. 
Anche in questo caso il meccanismo è quel- 
lo tradizionale degli editor RAD evoluti. Ogni 
controllo possiede proprietà e metodi 
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class MyThread : public wxThread 



{ public: 



MyThread(MyFrame *frame); 



virtual void *Entry(); 



virtual void OnExit(); 



void WriteText(const wxString& text); 



public: 



size_t m_count; 



MyFrame *m_frame; 



}; 



che richiede la sincronizzazione. Quindi possiamo 
gestire la mutua esclusione sulle operazioni di 
aggiornamento dell'interfaccia utente attraverso la 
chiamata al metodo wxMutexGuiEnter(). Appena 
ottenuto il permesso alla scrittura, compiamo l'ope- 
razione e rilasciamo la risorsa attraverso wxMutex- 
GuiLeave(). 

void MyThread: :OnExit() 
{} 



La derivazione dalla classe astratta wxThread impo- 
ne di implementare il metodo _virtual void* Entry ()" 
questo metodo è il cuore del processo. Infatti una 
volta creato il thread viene passato il controllo alla 
funzione Entry. All'uscita dalla procedura il thread 
viene interrotto. Andiamo a vedere in dettaglio i vari 
passaggi. 



MyThread:: 


MyThread(MyFrame 


*frame): 


wxTh 


read() 


{ m_count 


= 0; 








m_frame 


= fra me; 








} 



Il costruttore prende come parametro il frame con- 
tenente il textbox sul quale andare a scrivere. 

void MyThread: :WriteText (const wxString& text) 
{ wxString msg; 

wxMutexGuiEnterQ; 



msg << text; 



m_frame->WriteText(msg); 



wxMutexGuiLeaveQ; 



Quando le operazioni del thread terminano, oppure 
quando si decide di interrompere il procedimento, 
viene richiamata la funzione OnExit(). Nel nostro 
caso non sono necessarie operazioni "post-thread"; 
quindi la nostra funzione è vuota. Andiamo ora a 
vedere il nucleo del thread. 

void *MyThread::Entry() 
{ wxString text; 

text.Printf( wxT("Thread 0x%lx avviato(priorità = 
%u).\n"), GetldQ, GetPriorityQ); 

WriteText(text); 



for (m_count = 0; 



m_count < 10; 



m_count++ ) 



{ if ( TestDestroyQ ) break; 



text.Printf(wxT("[%u] Thread 0x%lx Scrive. \n"), 

m_count, GetldQ); 



WriteText(text); 



wxThread: :Sleep(1000);> 



text. Printf(wxT( "Thread 0x%lx è terminato. \n"), 

GetldQ); 



WriteText(text); 



return NULL; 



La scrittura sul textbox è un procedimento delicato } 



INSTALLARE WXDEVCPP 

Il processo di installazione è sufficientemente semplice. L'intera procedura è guidata da un comodo wizard. Seguiamolo 
passo passo e scegliamo le opzioni più utili 



> IL VIA 



> IL COMPILATORE 



> DEV C++ 
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I II processo di installazione è molto 
I semplice! Basta eseguire il setup ed il 
gioco è fatto! 



I II Setup installa oltre all'IDE la versio- 
I ne 3.4.0 del compilatore gec più le li- 
brerie statiche di wxWidgets 



I Non appena l'installazione è comple- 
I tata scegliamo di avviare DevC++ per 
configurarlo. 
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Il codice mostrato è molto semplice; bisogna, però, 
fare attenzione ad una serie di fattori. È buona nor- 
ma controllare spesso, all'interno della funzione En- 
try il valore restituito dalla funzione TestDestroy () . Se 
il valore restituito è true è necessario uscire dal 
thread il prima possibile. TestDestroyO restituisce 
true in caso di errori oppure nel caso in cui l'utente 
decida di interrompere il thread prima della sua 
naturale conclusione. A questo punto avviare il 
thread è semplice 

MyThread *thread = new MyThread(this); 

if(thread->Create()!= wxTHREAD_NO_ERROR ) 

{ wxMessageBox(wxT("Impossibile creare il thread!"));} 
else 

thread->Run(); 

Per metterlo in pausa possiamo utilizzare la 
funzione thread->Pause(). Su alcuni sistemi 
questo comando ha efficacia immediata, ovvero 
il thread viene interrotto subito. Su altri sistemi 
invece il flusso si interrompe dopo la prima 
invocazione di TestDestroyO. Per ripristinare 
un thread in pausa basta richiamare thread- 
>Resume(). Per interrompere il flusso invece è 
necessario chiamare thread->Delete(). Questa 
chiamata non solo interrompe l'esecuzione del 
thread ma rilascia anche le risorse ad esso asso- 
ciate e distrugge l'oggetto. È inutile andare a 
spiegare in dettaglio quali sono i problemi lega- 
ti alla sincronizzazione, perché noti alla grande 
maggioranza dei lettori e poi l'argomento è 
stato trattato in modo specifico negli scorsi 
numeri di io Programmo. Per limitare la possibi- 
lità di errore dello sviluppatore, wxWidgets 
mette a disposizione una serie di classi wrapper 



il cui scopo è quello di gestire lucchetti e sezio- 
ni critiche. Queste classi sono wxMutexLocker, 
wxCriticalSectionLocker. Il costruttore della 
classe wxMutexLocker bloccare un oggetto mu- 
tex. Tale oggetto viene poi rilasciato dal distrut- 
tore. Lo stesso vale per un oggetto di tipo wxCri- 
ticalsectionLocker. All'atto della costruzione 
avviene l'ingresso in una sezione critica. 
L'uscita avviene nel momento in cui viene invo- 
cato il distruttore. Di seguito viene riportato un 
esempio di tale operazione. 

void Funzione_di_prova() 

{ wxCriticalSectionLocker locker ( sezione_critica); 

if( ■■■ ) 

{ //compi delle operazioni 



return; } 



//fai altre operazioni. 



return; 



} 



subito dopo aver richiamato return; Il distrut- 
tore dell'oggetto locker si occupa di uscire dalla 
sezione critica individuata dall'oggetto globale 
sezione_critica. 



CONCLUSIONI 

Le possibilità offerte dal framework wxWidgets 
sono vaste e risulta difficoltoso riassumerle in 
poco spazio. La libreria comunque è documen- 
tata molto bene e non mancheremo di trattare 
ulteriormente le funzioni più interessanti 

Stefano Vena 
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Nella prima fase del setup possiamo 
I scegliere la lingua e lo stile dell'inter- 
faccia utente. 
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Poi possiamo scegliere se abilitare o 
I meno il completamento automatico 
del codice e il navigatore di classi. 



I Ora siamo pronti per utilizzare il no- 
I stro IDE gratuito integrato con wxWid- 



gets. 
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MANDARE UN SMS 
UN MMS A TEMPO 

LE WIRELESS MESSAGING API CI CONSENTONO DI REALIZZARE MIDLET PER INVIARE SMS 
E MMS. VEDREMO COME FARE IN MODO CHE I MESSAGGI VENGANO SPEDITI QUANDO 
DESIDERIAMO 




Q CD Q WEB 


Scheduledmessaging.zip 


\*QfML i- — Z Xj mW 



Tra i package opzionali che J2ME mette a di- 
sposizione degli sviluppatori, uno dei più 
interessanti è il WMA (Wireless Messaging 
API). Questo insieme di API consente, nella ver- 
sione 1.1, di inviare SMS (Short Message Service) e 
CBS (Celi Broadcast short message Service), nella 
versione 2.0 di inviare anche MMS (Multimedia 
Message Service). 

In quest'articolo vedremo prima di tutto come rea- 
lizzare una MIDlet per inviare SMS e come fare in 
modo che il messaggio venga spedito un certo gior- 
no ad una certa ora. Ci adopereremo poi a supe- 
rare un ostacolo che tutti gli sviluppatori J2ME han- 
no certamente incontrato: quello dei tanto odiati 
"permessi" che, se da una parte sono sicuramen- 
te uno strumento perla sicurezza, dall'altro costi- 
tuiscono un momento spesso fastidioso per un 



utente che utilizza applicazioni nelle quali viene 
utilizzata una classe considerata non sicura. 
In particolare per l'idea che vogliamo mettere in 
pratica, la problematica dei permessi rende poco 
utile l'applicazione. Supponiamo infatti di voler 
utilizzare un'applicazione di "scheduled messa- 
ging", perché dimentichiamo di fare gli auguri ai 
nostri amici. Quindi, componiamo il messaggio di 
auguri una settimana prima (o quando ci viene in 
mente) e lasciare che la nostra applicazione lo in- 
vìi all'occorrenza può essere un'ottima soluzione. 
In questo caso, se il giorno del compleanno del no- 
stro amico, all'ora da noi decisa, il programmino 
ci chiederà "Sei sicuro di voler inviare il messag- 
gio?", la cosa può anche non disturbarci ma, sicu- 
ramente, a parte forse il tempo risparmiato per 
pensare e scrivere il messaggio, rispetto ad un prò- 



COME FUNZIONERÀ L'APPLICAZIONE? 

Vediamo i semplici passi che consentono di schedulare l'invio di SMS 



> START SMS! 




3451234567 



Ora e data ora di spedizione: 
15:40 13/01/2006 



Opzioni 



I Avviata l'applicazione per l'invio de- 
I gli SMS, compare la schermata dove 

inserire numero del destinatario, data e 

ora di spedizione. 

Abbiamo aggiunto qualche controllo per 

la validità dei formati. 



> SCRITTURA E INVIO SMS 




Ciao, come va? 



Invia 



Esci 



Seleziona 



Annulla 



Premendo il tasto relativo allo voce 
"OK" dalla schermata iniziale, com- 
pare la schermata dove scrivere il testo del 
messaggio. Premendo "Invia "l'applicazio- 
ne si chiude e alla data e ora stabilita l'SMS 
verrà inviato. 



> START MMS! 

r 




Subject: 
Saluti 



Destinatario: 
3451234567 

Allegati: 



Ora e data ora di spedizione: 

15:52 13/01/2006 



Opzioni 



Chiudii 



Avviata l'applicazione per l'invio de- 
gli MMS, compare la schermata dove 
inserire subject, destinatario, data e ora di spe- 
dizione. 

Anche in questo caso valgono i controlli usa- 
ti nel passo 1 . 
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gramma agenda in cui si segnano gli appunta- 
menti e che produce un alert all'ora desiderata, 
non è cambiato granché. 

Ricordiamo a chi non fosse un grande esperto che 
anche settando nel jad relativo alla MIDlet i per- 
messi per una determinata classe, ovvero la pos- 
sibilità che la classe venga eseguita senza richie- 
derne conferma all'utente, in realtà ha validità so- 
lo se la nostra applicazione risulta "signed", ovvero 
certificata da un apposito ente e si connette sol- 
tanto a domini protetti (Trusted 3rd party) . Ovvia- 
mente far certificare la propria applicazione co- 
sta. . . Quello che faremo per aggirare il problema sarà 
una sorta di hacking, ovvero cloneremo il proto- 
collo sms con un altro protocollo ("vsms") per il 
quale non setteremo alcuna opzione relativamen- 
te ai permessi. Fatto ciò vedremo come realizzare 
una MIDlet per inviare MMS in maniera pro- 
grammata. Questa volta lasceremo a voi lettori la pos- 
sibilità di realizzare l'hacking, del tutto simile a 
quello del caso precedente. 



INVIO SCHEDULATO 
DEGLI SMS 

La MIDlet che utilizziamo per la programmazio- 
ne e gli invìi di SMS è SMSMIDlet. 
Progettiamo questa MIDlet in modo che quando av- 
viamo l'applicazione ci compaia un Form contenente 
un TextField e un DateField. 
Nel TextField l'utente può inserire il numero di te- 
lefono del destinatario. Alcuni telefoni, per default, 



consentiranno di aggiungere il numero dalla ru- 
brica. Nel DateField viene visualizzata l'ora e la da- 
ta attuale. Se l'utente non modifica tale impostazione 
l'SMS sarà spedito immediatamente, altrimenti 
sarà inviato alla data e ora di spedizione. 
Vediamo come costruire questi due campi e come 
inserirli nel Form: 

Form smsForm = new Form("SMS"); 
TextField destinationAddressField = new 

TextField("A:",null, 13, TextField.PHONENUMBER); 
DateField sendingDateField = new DateField("Ora 

e data ora di spedizione:", DateField. DATE_TIME); 
Date actualDate = new Date(); 
sending DateField. setDate(actualDate); 
smsForm.append(destinationAddressField); 
smsForm.append(sendingDateField); 

Come si vede, nella costruzione del TextField spe- 
cifichiamo che il testo sia un numero di telefono. Inol- 
tre con il metodo setDate di DateField impostia- 
mo come data da visualizzare quella attuale. Una 
volta che l'utente ha inserito queste informazioni 
non gli resta che scrivere il messaggio. Il Form avrà 
pertanto un Command che gli consente di visua- 
lizzare un'ulteriore schermata. Prima che ciò av- 
venga possiamo pensare di eseguire un controllo 
sul numero di telefono, per stabilire se sia corret- 
to. Infatti, non aver specificato come tipo di testo 
un numero di telefono, non ci preserva dall'inse- 
rimento di un numero non corretto. Il campo PHO- 
NENUMBER prevede, oltre ai numeri, un insieme 
di caratteri, che variano da telefono a telefono, e 




> SCELTA TIPO 
ALLEGATO 



HÉÈ 



MMS 



O Testo 

® Immagine 

O Audio 

O Video 



Opzioni 



Indietro 



I Premendo il tasto relativo allo voce "In- 
I serisci oggetto" dalla schermata ini- 
ziale, compare la lista delle tipologie di alle- 
gato. Bisogna selezionare la tipologia desi- 
derata e premere "Avanti". Scegliendo "Te- 
sto" s\ passa alla scrittura del testo. 



> SELEZIONE FILE 
ALLEGATO 



-, 



C:/Nokia/ 
Images/ 



Q 1200.jpg 
Background^/ 
FE_img/ 
Pictures/ 
Presence/ 



Opzioni 



Scegliendo le opzioni diverse da "Te- 
I sto"si apre un file browser. Scorrendo 
tra le directory si arriva a selezionare il file 
desiderato premendo "Apri/Seleziona". 
Esattamente come quando alleghiamo un 
file in attach ad una e-mail 



> VISUALIZZAZIONE ALLEGATO 
E INVIO MMS 



ÉÉ 



NMS 




Opzioni 



Cancella 



ir 



Il file viene aperto e potete vedere 
I l'immagine o il video oppure ascolta- 
re l'audio. Premendo "OK" tornate alla 
schermata iniziale, premete "invia". 
L'applicazione si chiude e alla data e ora 
stabilita l'MMS verrà spedito. 
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che sono ad esempio "+" e "*". Un numero del tipo 
"++393. . . "ad esempio non è corretto. Realizziamo 
allora una funzione che controlla che la lunghez- 
za del numero sia maggiore di 0, e che accetti nu- 
meri che iniziano con "+": 

private static boolean isValidPhoneNumber(String 

number) { 
[■■■] 
> 

In realtà possiamo eseguire altri controlli, anche 
sulla lunghezza, che abbiamo deciso essere al mas- 
simo di 13 caratteri. 

Quando l'utente digiterà sul telefono il tasto cor- 
rispondente ad "OK" verrà chiamato il metodo pre- 
SendingO: 



dulata. Il costruttore di SMSsendingè il seguente: 



public SMSsending(Display display, 

Displayable backScreen, SMSMIDIet smsMIDIet) { 
this. display = display; 
this.destinationAddress = nuli; 
this. backScreen = backScreen; 
this. smsMIDIet = smsMIDIet; 
messageAlert = new Alert("", nuli, nuli, 

AlertType.ERROR); 
messageAlert. setTimeout(5000); 
messageBox = new TextBox("Testo Messaggio", 

nuli, 65535, TextField.ANY); 

messageBox. addCommand(backCommand); 
messageBox. addCommand(sendCommand); 
messageBox. setCommandListener(this); 



private void preSending () { 



[...] 



smsSending.composeSMS("sms://" + address, 

sendingDate); 



} 



Trovate l'implementazione completa nel CD. Que- 
sto metodo verifica la correttezza del numero, in 
caso negativo visualizza una pop-up di errore (uti- 
lizzando un Alert) e infine chiama il metodo com- 
poseSMS dell'oggetto smsSending di tipo SMSsen- 
ding. La classe SMSsendingè quella che si occupa 
dell'effettivo invio del messaggio. Essa estende la clas- 
se TimerTask responsabile dell'esecuzione sche- 



FILE CONNECTION API 



Le FileConnection API insieme alle 
PIM (Personal Information Manage- 
ment) API costituiscono il PDA Pro- 
file. Si tratta di funzionalità per po- 
ter, rispettivamente, accedere al fi- 
le system del telefono e di eventua- 
li memorie esterne e alle informa- 
zioni personali quali quelle conte- 
nute nella rubrica, nell'agenda, nel- 
le note. È solo da poco tempo che i 
telefoni cellulari hanno iniziato a 
fornire il supporto per questo tipo 
di API. E fino ad allora ciò rendeva 
le applicazioni scritte in codice nati- 
vo su sistema operativo (Symbian 
OS su tutti) inarrivabili rispetto alle 
applicazioni J2ME, relegate spesso 
nel contesto del mobile gaming. 
Ora finalmente si possono sviluppa- 
re applicazioni utili e interessanti, 
sfruttando i vantaggi di Java: por- 
tabilità e compatibilià. Le FileCon- 
nection API sono definite nel 
package javax.microedition.io.file e 
permettono, come già detto di ac- 
cedere al file system, in lettura e in 



scrittura. Queste sono le interfac- 
ce/classi comprese: 

• FileSystemRegistry: classe che 
permette di sapere quali file sy- 
stem sono presenti sul nostro di- 
spositivo (memoria interna, me- 
mory card, ecc.) 

• FileSystemListener: interfaccia 
utilizzata per avere informazioni 
sui cambiamenti del file system 
(ad esempio inserimento di me- 
mory card) 

• FileConnection: interfaccia per la 
connessione a file e directory in 
lettura e in scrittura 

• ConnectionClosedException: 
eccezione generata quando si 
cerca di effettuare un'azione su 
un file ma la connessione risulta 
chiusa 

• UlegalModeException: eccezione 
generata quando si cerca di acce- 
dere ad un file in modalità diversa 
rispetto a quella utilizzata in aper- 
tura. 



La classe in questione prende dalla MIDlet i para- 
metri di cui ha bisogno, ovvero il riferimento al Di- 
splay, il Form di start a cui si deve poter ritornare e 
un'istanza della MIDlet. Inoltre viene costruita la Text- 
Box da utilizzare per la scrittura del messaggio. 
Il metodo composeSMS invocato dalla MIDlet non 
fa altro che acquisire l'indirizzo di destinazione del 
messaggio e la data di invio, e visualizza la Text- 
Box: 

public void composeSMS(String destinationAddress, 

Date sendingDate) { 
this.destinationAddress = destinationAddress; 
this. sendingDate = sendingDate; 
display.setCurrent(messageBox); 



> 



Si noti che l'indirizzo di destinazione è del tipo pro- 
tocollo:/ /indirizzoiporta, nel nostro caso "sms://393. . . ". 
Non specificando la porta viene utilizzata quella 
assegnata per default dal telefono all'invio degli 
SMS. 

Una volta che l'utente ha terminato la scrittura del 
messaggio utilizzerà il tasto "Invia" per spedirlo. 
Nel CommandAction la pressione di questo tasto ge- 
nera questo effetto: 



if(c 



sendCommand) { 



Timer sendingTimer = new Timer(); 
TimerTask sendingTask = this; 
sendingTimer.schedule(sendingTask,sendingDate); 
smsMIDIet. sleepApp(); 
} 



In pratica costruiamo un Timer, e un TimerTask, 
ovvero l'azione da eseguire quando il Timer sca- 
de, e scheduliamo il task alla data e ora decisa dal- 
l'utente. Siccome la classe SMSsending estende Ti- 
merTask, il task eseguito allo scadere del Timer è 
il metodo run () di SMSsending. 
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Nel frattempo che arriva il momento dell'invio la MID- 
let viene resa "dormiente": 

public void sleepApp() { 

display.setCurrent(null); 
} 



Ciò significa che l'applicazione resta aperta, non 
rilascia le sue risorse, pur se "visivamente" sem- 
bra di esserne usciti. 

Come abbiamo detto, allo scadere del Timer vie- 
ne eseguito il metodo run(): 

public void run() { 

String address = destinationAddress; 
MessageConnection smsconn = nuli; 

try { 

smsconn = (MessageConnection) 

Connector.open(address); 
TextMessage txtmessage = (TextMessage) 

smsconn. newMessage( 
MessageConnection. TEXT_MESSAGE); 
txtmessage. setPayloadText( 

messageBox.getStringO); 
smsconn. send(txtmessage); 
} catch (Throwable t) { 

messageAlert = new Alert("", "SMS non 

inviato!", nuli, AlertType.ERROR); 
messageAlert. setTimeout(5000); 
display.setCurrent(messageAlert); 
smsMIDIet.quitAppO; 

} 

if (smsconn != nuli) { 

tryj 

smsconn. close(); 

messageAlert = new Alert("", "SMS 

inviato!", nuli, AlertType.INFO); 
messageAlert. setTimeout(5000); 

display.setCurrent(messageAlert); 
smsMIDIet.quitAppO; 
} catch (IOException ioe) { 
messageAlert = new Alert("", 

"Connessione non riuscita!", 
nuli, AlertType.ERROR); 
messageAlert. setTimeout(5000); 

display.setCurrent(messageAlert); 
smsMIDIet.quitAppO; 



} 



Analizziamo il comportamento di questo metodo. 
La prima cosa che ci si aspetta è che venga stabili- 
ta una connessione. E infatti l'invio di sms è im- 
plementato da un'interfaccia Connection e, nel ca- 
so specifico, da un MessageConnection.. Per aprire 
la connessione, l'applicazione ottiene un oggetto 
che implementa il MessageConnection dalla classe 



Connector, attraverso una URL che identifica l'in- 
dirizzo. Per quanto riguarda il messaggio vero e 
proprio, esso è rappresentato dall' interfaccia Mes- 
sage e dalle interfacce da essa derivate. In partico- 
lare per un SMS, l'interfaccia a cui far riferimento 
è TextMessage. Si costruisce quindi un nuovo Text- 
Message a partire dal MessageConnection e poi si 
"riempie" il suo payload con la stringa di testo ot- 
tenuta dal MessageBox. A questo punto utilizzan- 
do il metodo send di MessageConnection il mes- 
saggio viene spedito. 

Da notare che i protocolli wireless a cui si accede tra- 
mite le WMA sono tipicamente del tipo store-and- 
forward, diversamente dai datagram del livello re- 
te. Questo significa che il messaggio viene conse- 
gnato quando il destinatario sarà connesso, anche 
se questo non accade al momento dell'invio. 
Per rendere maggiormente usabile la nostra ap- 
plicazione ricorriamo ad una serie di Alert che pos- 
sano comunicare all'utente, se il messaggio è sta- 
to inviato o meno o se, non essendoci campo, non 
è stata possibile stabilire la connessione. Si ricor- 
di che questo è il caso di invio "standard", cioè quel- 
lo in cui al momento dell'invio il telefono chiede 
all'utente il permesso di inviare il messaggio. 



HACKING DEL 
PROTOCOLLO "SMS" 

Il nostro scopo è quello di rendere l'applicazione com- 
pletamente autonoma, e dover confermare l'invio 
del messaggio risulta in questo senso veramente 
fastidioso. 

Come già accennato utilizziamo allora un "clone" 
del protocollo "sms". Lo chiamiamo "vsms" ma po- 
tete chiamarlo come più vi piace. 
Le classi che abbiamo descritto finora restano inal- 
terate tranne per il fatto che nell'indirizzo di de- 
stinazione il nome del protocollo ora sarà "vsms" e 
non più "sms". 

Le WMA implementano il protocollo sms attra- 
verso una serie di classi che, a seconda del telefo- 
no, sono contenute un diverso package tra quelli che 
costituiscono il MIDP. Ad esempio per la Series60 
di Nokia, che ha un sistema operativo Symbian, il 
package in questione è il seguente: com. sym- 
bian. midp. io.protocol.sms. 
La realizzazione del protocollo "vsms", nascerà 
quindi dalla creazione del package com. sym- 
bian. midp. io.protocol. vsms. 
All'interno di questo package scriviamo due clas- 
si, presenti anche nel package sms: Protocol e SM- 
SClientConnectionlmpl. In realtà nel package sms 
è contenuta anche la classe SMSServerConnectio- 
nlmpl, ma non ne abbiamo bisogno perché essa 
viene utilizzata per la ricezione degli SMS. 
Visto che l'argomento può risultare ostico e i lettori 
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potrebbero avere difficoltà a riprodurre i file sorgenti 
delle due classi riscritte, vi invitiamo a consultare 
il codice allegato all'articolo per avere una visione 
più completa. 
Cominciamo dalla classe Protocol: 

package com.symbian.midp. io. protocol. vsms; 

import com.symbian.gcf.*; 

import com.symbian.javax. wireless. messaging. 

SMSConnectionSession; 
import java.io.IOException; 
import javax.microedition. io. Connection; 
public final class Protocol extends ProtocolBase { 



implements MessageConnection { 



public Protocol() { 



super("sms", "vsms"); 



> 



public void ensurePermission(String aName) { 



// qui non facciamo niente} 



public Connection openConnection(URI allri, 

int aMode, boolean aTimeouts) 



throws IOException { 



if(aUri.toString().startsWith("vsms")) 
allri = new URI(aUri.toString().substring(l)); 
com.symbian.gcf.ConnectionSession session = 
SMSConnectionSession. getSession(); 
String host = allri. getHost(); 
ConnectionEndPoint connection; 
if(isServerConnection(allri)) 

connection = nuli; 
else { 

if(aMode == 1) 

throw new IllegalArgumentException(); 
connection = new SMSCIientConnectionImpl( 
session, allri, 2); 
} 



connection. open(); 



return connection; 



> 



protected boolean isServerConnection(URI allri) { 
return allri. getHost().length() == 0; 



> 



In questa classe il metodo ensurePermission(String 
aname) lo implementiamo come un metodo vuo- 
to. Per il resto questa classe non fa altro che stabi- 
lire una connessione invocando SMSClientCon- 
nectionlmpl: 

package com.symbian.midp. io. protocol. vsms; 

import com.symbian.gcf.*; 

import com.symbian.javax. wireless. messaging.*; 

import com.symbian.util.NativeError; 

import java.io.IOException; 

import java.io.InterruptedIOException; 

import javax. wireless. messaging.*; 

class SMSClientConnectionlmpI extends 

DatagramConnectionEndPoint 



[...] 



protected static void checkSecurity(String 
aPermission, String aPermissionArgs[]) { 



> 



} 



Come si può vedere questa è la classe per la crea- 
zione di un nuovo messaggio e per l'invio. Nel co- 
dice è stata lasciata tutta la parte relativa ai per- 
messi tranne poi rendere vuoto il contenuto del 
metodo checkSecurity, che è quello che genera la fa- 
stidiosa richiesta di conferma all'utente. 
Ora possiamo ricompilare le nostre classi e creare 
il nuovo jar. Non bisogna però installarlo sul te- 
lefono. Infatti dopo aver installato la versione sen- 
za hacking bisogna sostituire il jar originale con 
quello modificato. Per localizzare la midlet sul te- 
lefono (sarà in una posizione del tipo "E:/Sy- 
stem/MIDlets/ [12345678] ") per la Series60 si può 
utilizzare FExplorer. 

Fatto questo siamo pronti a lanciare l'applicazio- 
ne e ad inviare messaggi senza che ce ne venga 
chiesta conferma. La procedura può sembrare po- 
co ortodossa ma funziona! 



INVIO SCHEDULATO 
DEGLI MMS 

La MIDlet che utilizziamo per inviare MMS è MM- 
SMIDlet. Progettiamo questa MIDlet in modo che 
all'avvio dell'applicazione compaia un Form con- 
tenente due TextField, uno per il subject del mes- 
saggio e l'altro per il numero di telefono o l'indiz- 
zo email del destinatario, uno Stringltem che ri- 
porta il numero di allegati del messaggio e, come 
per gli sms, un DateField dove viene visualizzata 
l'ora e la data attuale. Se l'utente non modifica ta- 
le impostazione l'mms sarà spedito immediata- 
mente, altrimenti sarà inviato alla data e ora di spe- 
dizione. Vediamo come costruire questi campi e 
come inserirli nel Form: 

Form mmsForm = new Form("MMS"); 

TextField subjectField = new TextField("Subject:", nuli, 
256, TextField .ANY); 

TextField destinationField = new TextField("Destinatario: 
", nuli, 256, TextField.ANY); 

Stringltem partsLabel = new StringItem("Allegati:", "0"); 

DateField sendingDateField = new DateField("Ora e data 
ora di spedizione:", DateField. DATE_TIM E); 

Date actualDate = new Date(); 

sendingDateField. setDate(actualDate); 

mmsForm.append(subjectField); 

mmsForm.append(destinationField); 

mmsForm.append(partsLabel); 
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mmsForm.append(sendingDateField); 

Una volta che l'utente ha inserito queste informa- 
zioni deve aggiungere gli allegati al messaggio. Il 
Form ha pertanto un Command ("Inserisci ogget- 
to") che consente di visualizzare una lista delle ti- 
pologie di allegati: testo, immagine, audio, video. In 
particolare quando si invia il comando "Inserisci 
oggetto" viene chiamata la classe PartsDialog e il 
suo metodo show(): 



if (e: 



CMD_ADD_PART) { 



if (partsDialog 



nuli) { 



partsDialog = new PartsDialog(this); 



} 



partsDialog. show(); 



} 



deo/mpeg",ecc.), il content-id dell' allegato (es. "idi" 
"id2", ecc.), il content- location dell'allegato ("nuli" 
per il testo, il path del file per gli altri allegati), il 
tipo di codifica dell'allegato. 
L'oggetto MessagePart può generare un'eccezione 
SizeExceededException nel caso in cui la dimen- 
sione dell'allegato superi quella consentita. 
Costruito l'allegato viene visualizzato il Form ini- 
ziale in cui il numero di allegati viene aggiornato: 

mmsMIDIet.getMessage( ).addPart(new MessagePart( 
contents, 0, contents.length,mimeType, 
"id" + counter, nuli, encoding)); 
counter++; 
mmsMIDIet.show( ); 

void show() { 




La classe PartsDialog è quella che si occupa della 
gestione degli allegati e il metodo show() mostra la 
lista delle tipologie di allegati. Si tratta di una lista 
a scelta esclusiva, per cui bisogna selezionare una 
delle tipologie: 

public PartsDialog(MMSMIDIet mmsMIDIet) { 

this.mmsMIDIet = mmsMIDIet; 



partsl_abel.setText(Integer.toString( 



String[] stringArray : 



{"Testo", "Immagine", 

"Audio", "Video"}; 



typeList = new List("MMS", Choice.EXCLUSIVE, 

stringArray, nuli); 



typeList. addCommand(CMD_BACK); 



typeList. addCommand(CMD_NEXT); 



typeList. setCommandListener(this); 



public void showQ { 



mmsMIDIet. getDisplayQ.setCurrent(typeList); 



} 



La scelta della tipologia di testo provoca la chia- 
mata della classe TextDialog di PartsDialog, un 
Form contenente una TextField dove inserire il te- 
sto del messaggio. Una volta inserito il testo, i da- 
ti vengono incapsulati in un array di byte e codifi- 
cati secondo la codifica UTF-8. A questo punto l'al- 
legato sarà memorizzato in un oggetto Message- 
Part, fornito dalle WMA e il cui costruttore da noi 
utilizzato è: 

MessagePart(byte[], int, int, String, String, String, String) 

I parametri di questo costruttore sono rispettiva- 
mente un array di byte contenente i dati, l'offset 
(posizione di inizio dei dati all'interno dell'array), 
la lunghezza in byte dei dati, il MIME content- ty- 
pe ("text/plain", "image/png", "audio/midi", "vi- 



partsDialog. counter)); 



display.setCurrent(mmsForm); 



} 



Supponiamo ora di voler allegare un file, cioè un'im- 
magine, un audio o un video. 
Ripetiamo la procedura precedente con scelta dal- 
la lista e stavolta è invocata la classe ImageDialog 
o AudioDialog o VideoDialog di PartsDialog. 
Per poter selezionare un file all'interno del telefo- 
no facciamo ricorso alle FileConnection API, ovve- 
ro una serie di funzionalità opzionali che J2ME 
mette a disposizione per poter accedere al file sy- 
stem. 

L'idea è quella di utilizzare queste API per costrui- 
re un file browser che ci permetta di scorrere al- 
l'interno della memoria del telefono e di un'even- 
tuale memory card fino a selezionare il file desi- 
derato. Costruiamo pertanto una classe thread di 
appoggio, FileBrowser che viene chiamata all'in- 
terno del costruttore di ImageDialog o AudioDia- 
log o VideoDialog: 

FileBrowser fb = new FileBrowser(this, mmsMIDIet, 

mimeType); 
fb.start(); 

dove la stringa mimeType vale rispettivamente 
"image/*", "audio/*", "video/*". Il metodo run () di 
FileBrowser invoca showCurrDir(). Questo meto- 
do si occupa proprio di mostrare il contenuto del- 
la directory corrente e applicandolo ricorsivamente 
avremo il nostro browser. 
Vediamo allora come opera questo metodo: 

private void showCurrDir() { 
Enumeration e; 
List browser; 
try { 



http://www.ioprogrammo.it 



Aprile 2006/ 101 ► 



SISTEMA 



Un'applicazione J2ME per inviare SMS e MMS schedulati 




if (MEGA_ROOT.equals(currDirName)) { 
e = FileSystemRegistry.listRootsO; 
browser = new List(currDirName, 

List.IMPLICIT); 

} else { 

currDir = (FileConnection)Connector.open( 

"file://localhost/" + currDirName, 
Connector.READ); 
e = currDir.list(); 
browser = new List(currDirName, 

List.IMPLICIT); 

browser.append(UP_DIRECTORY, dirlcon); 
browser.addCommand(back); 



while (e.hasMoreElementsO) { 
String fileName = (String)e.nextElement(); 



if (fileName. charAt(fileName.length()-l) 



SEP) { 



// questa è una directory 



browser.append(filel\lame, dirlcon); 



} else { 



// questo è un file 



browser.append(fileName, filelcon); 



browser.setSelectCommand(open_select); 



browser.addCommand(exit_browser); 
browser.setCommandListener(this); 
if (currDir != nuli) { 



currDir.closeQ; 



msMIDIet.getDisplay().setCurrent(browser); 



} catch (IOException ioe) { 



ioe.printStackTrace(); 



> 



Inizialmente, cioè al livello più alto del file system, 
il metodo FileSystemRegistry.listRootsO fornito dal- 
le FC API restituisce un oggetto Enumeration con- 
tenente la lista delle root presenti sul file system. Que- 
sti oggetti vengono aggiunti ad un List per poter 
riprodurre visivamente la lista delle root sul te- 
lefono. 

Una volta selezionata una root il CommandAction 
invoca il metodo che serve ad "attraversare" le di- 
rectory: traverseDirectory (String). Questo metodo 
riconosce se l'operazione richiesta è verso l'alto 
(uscire dalla directory corrente) o verso il basso 
(entrare nella directory corrente), quindi chiama 
showCurrDir( ) per la visualizzazione del conte- 
nuto della directory. 

Questa volta showCurrDir () costruisce un ogget- 
to FileConnection attraverso il metodo Connec- 
tor.open, che ha come argomenti una uri nel for- 
mato file://<host>/<path> (ad esempio file://C:/No- 



kia/Images/imageOOl.jpg) e la modalità di apertu- 
ra del file (lettura, scrittura o entrambi). 
Anche in questo caso potete provare a realizzare 
un hacking per evitare che ogni volta che entrate in 
una directory o aprite un file vi venga chiesto il per- 
messo! 

Dall'oggetto FileConnection tramite il metodo li- 
sto si ottiene nuovamente un Enumeration e si 
procede come prima. Tutto ciò viene ripetuto fino 
a quando l'oggetto selezionato non è una direc- 
tory ma un file (ciò può essere facilmente ricono- 
sciuto dal fatto che il path di una directory termi- 
na con il separatore "/"). È nel CommandAction 
che viene effettuato questo riconoscimento e, se in 
effetti l'operazione eseguita dall'utente non è del ti- 
po "Apri directory" ma. del tipo "Seleziona file", vie- 
ne invocato il metodo selectFile (String currFile): 

private void selectFile(String fileName) { 

try { 

String currContentLocation = 

"file://localhost/" + currDirName + fileName; 
FileConnection fc = (FileConnection)Connector. 

open(currContentLocation, Connector.READ); 
if (Ifc.existsQ) { 



throw new IOException("II file non esiste"); 



} 



InputStream is = fc.openlnputStreamQ; 



fc.closeQ; 



this.setContent(is); 



this.setContentLocation(currContentLocation); 
if (mimeType.startsWith("image")) { 

PartsDialog.ImageDialog imageDialog = 

(PartsDialog.ImageDialog)dialog; 
imageDialog. play(); 
mmsMIDIet.getDisplay(). 

setCurrent(imageDialog); 
} else if (mimeType.startsWith("audio")) { 
PartsDialog.AudioDialog audioDialog = ( 

PartsDialog.AudioDialog)dialog; 
audioDialog. play(); 
mmsMIDIet.getDisplay(). 

setCurrent(audioDialog); 
is.close(); 
} else if (mimeType.startsWith("video")) { 
PartsDialog.VideoDialog videoDialog = 

(PartsDialog.VideoDialog)dialog; 
videoDialog. play(); 
mmsMIDIet.getDisplay(). 

setCurrent(videoDialog); 
is.close(); 



Come si vede viene costruito un FileConnection 
sul file selezionato, in modo da aprirlo in lettura, e 
poi il contenuto del file viene inserito in un Input- 
Stream utilizzando il metodo openInputStream( ) 
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di FileConnection. Le FileConnection API permet- 
tono anche una gestione smart del file system che 
possiamo applicare perfettamente al nostro caso. 
Possiamo pensare, infatti, invece di dover scorre- 
re tutto il file system per selezionare un file, di cir- 
coscrivere la ricerca ad esempio per le immagini 
alla directory delle immagini, ai video alla direc- 
tory dei video, ai file audio alla directory degli au- 
dio. Infatti, utilizzando delle proprietà del sistema 
si possono ricavare le URL di particolare directory: 

• fìleconn.dir.photos: directory dove vengono 
salvate le foto o le immagini 

• fìleconn.dir.videos: directory dove vengono 
salvati i video registrati o scaricati 

• fileconn.dir.audios: directory dove vengono 
salvati audio (comprese suonerie) registrati o 
scaricati: 

Le URL ricavate possono essere poi passare al me- 
todo Connector.open: 

String imagesDir = 

System. getProperty("fileconn. dir. photos"); 
FileConnection fc = (FileConnection)Connector. 

open(imagesDir,Connector.READ); 

String videoDir = System. getProperty 

("fìleconn.dir.videos"); 
FileConnection fc = (FileConnection)Connector. 

open(videoDir,Connector.READ); 



Ora basterà premere "OK" dal proprio telefono e 
come nel caso del testo verrà costruito l'oggetto 
MessagePart, per il quale a differenza di prima l'al- 
legato è non un array di byte ma un InputStream. 
Lo stesso vale per gli allegati audio e video. 
Diamo ora uno sguardo a come viene implemen- 
tata la riproduzione degli allegati audio e video. 
L'oggetto utilizzato per la riproduzione è il Player. 
Il MIDP 2.0 contiene Y Audio Building Block che 
supporta la riproduzione di toni, sequenze di toni 
e file wav. Per audio diversi (midi, mp3, au) e vi- 
deo, abbiamo bisogno di un telefono che suppor- 
ti le MMAPI (Mobile Media API). Con queste API 
possiamo realizzare dei player completi, dotati di 
controllo di volume, velocità, ecc. 
In questo caso, poiché il nostro scopo è un altro, 
ci limiteremo ad utilizzare il Player per una sem- 
plice riproduzione audio o video. 
Partiamo dall'audio: 

InputStream content = fb.getContent(); 

String contentLocation = fb.getContentl_ocation(); 

try { 

Player player = Manager.createPlayer( 

contentLocation); 

player, sta rt(); 



} catch(IOException ioe) { 



ioe.printStackTrace(); 



} catch(MediaException me) { 




me.printStackTrace(); 



} 



String audioDir = System. getProperty 

("fileconn.dir.tones"); 



FileConnection fc 



(FileConnection)Connector. 
open(audioDir,Connector.READ); 



Basta chiamare il metodo start() del Player per ri- 
produrre l'audio. Per la riproduzione video utiliz- 
ziamo un VideoControl per accedere al display del 
telefono: 



Questo è quindi un metodo alternativo alla nostra 
implementazione, che per completezza didattica 
realizza un file browser vero e proprio. 
A questo punto possiamo pensare di visualizzare l'im- 
magine, ascoltare l'audio o riprodurre il video pri- 
ma di allegarlo al messaggio. Quindi in base al con- 
tent-type del file viene chiamato il metodo play() 
di ImageDialog, AudioDialog oppure VideoDialog. 
Cominciamo con ImageDialog, il metodo play() 
apre l'immagine e la visualizza: 

InputStream content = fb.getContent(); 

Image img = nuli; 

try 



img = Image. createlmage(content); 
content. closeQ; 



> 



catch (IOException e) 



{ e.printStackTrace();} 



this.append(img); 



InputStream content = fb.getContent(); 

String contentLocation = fb.getContentl_ocation(); 

try { 

Player player = Manager.createPlayer( 

contentLocation); 
player.realize(); 
VideoControl ve = (VideoControl)( 

player.getControl("VideoControl")); 
Item videoltem = (Item) vc.initDisplayMode( 

GUIControl.USE_GUI_PRIMITIVE, nuli); 

append(videoltem); 
player.start(); 
vc.setVisible(true); 
content. close(); 
} catch(IOException ioe) { 

ioe.printStackTrace(); 

} catch(MediaException me) { 

me.printStackTrace(); 



Supponendo ora di aver inserito tutti gli allegati 
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che desideravamo, l'applicazione ci riporta al Form 
iniziale dove viene visualizzato il subject, il desti- 
natario e il numero di allegati e non ci resta che 
dare il comando "Invia". Quando facciamo ciò vie- 
ne chiamato il metodo preSending () di MMSMIDlet 
che prepara il messaggio per poi passarlo alla clas- 
se MMSsending: 

private void preSending() { 

try { 

String address = "mms://" + 

destinationField.getStringO; 
message.setSubject(subjectField.getString()); 
message.setDestination(address); 
Date sendingDate = sendingDateField.getDateQ; 



MULTIPART_MESSAGE); 



mmmessage.setAddress(address); 



String statusMessage 



"Invio messaggio a 
" + address + 



sendingMessageAlert.setString(statusMessage); 
Timer sendingTimer = new Timer(); 
TimerTask sendingTask = new MMSsending( 

message, sendingDate); 
sendingTimer.schedule 

(sendingTask,sendingDate); sleepApp(); 

} 

catch (IllegalArgumentException iae) { 

errorMessageAlert.setString(iae.getMessage()); 

display.setCurrent(errorMessageAlert); 



L'oggetto message è di tipo MMSMessage, che è una 
classe di appoggio contenente i metodi ausiliari 
per settare o restituire subject, destinatario e alle- 
gati del messaggio. Questo oggetto è quello che poi 
viene preso in consegna da MMSsending per l'in- 
vio vero e proprio. 

All'interno del metodo preSending () costruiamo 
un Timer ed un TimerTask, ovvero l'azione da ese- 
guire quando il Timer scade, e scheduliamo il task 
alla data e ora decisa dall'utente. 
Il TimerTask è proprio MMSsending, perciò allo 
scadere del Timer viene eseguito il metodo run () 
di MMSsending: 

public MMSsending(MMSMessage message, Date 

sendingDate) { 
this. message = message; 
this. sendingDate = sendingDate; 



public void run() { 

String address = message. getDestination(); 
MessageConnection mmsconn = nuli; 

try { 

mmsconn = (MessageConnection) 

Connector.open(address); 



MessagePart[] parts = message. getParts(); 
for (int i = 0; i < parts. length; i++) { 
mmmessage.addMessagePart(parts[i]); 



mmmessage.setSubject(message.getSubject()); 

mmsconn. send(mmmessage); 
} catch (Exception e) { 

e.printStackTrace(); 



if (mmsconn != nuli) { 

try { 

mmsconn. close(); 

} 

catch (IOException ioe) { 
ioe.printStackTraceQ; 



MultipartMessage mmmessage 



(MultipartMessage) 



mmsconn. newMessage(MessageConnection. 



> 



Come per gli sms anche l'invio di mms è imple- 
mentato da un'interfaccia MessageConnection. Per 
aprire la connessione l'applicazione ottiene un og- 
getto che implementa il MessageConnection dalla 
classe Connector, attraverso una URL che identi- 
fica l'indirizzo. 

Per quanto riguarda il messaggio vero e proprio, 
esso è rappresentato dall'interfaccia Multipart- 
Message. Si costruisce quindi un nuovo Multipart- 
Message a partire dal MessageConnection e poi si 
aggiungono i vari allegati attraverso il metodo add- 
MessagePart. A questo punto utilizzando il meto- 
do send di MessageConnection il messaggio viene 
spedito. 



CONCLUSIONI 

In questo articolo abbiamo visto come, utilizzan- 
do le WMA, sia possibile inviare sms e mms su 
J2ME. Inoltre abbiamo reso più interessante l'ap- 
plicazione realizzata fornendo la possibilià di fa- 
re degli invìi programmati. 
Abbiamo inoltre analizzato l'hacking del proto- 
collo "sms" al fine di evitare la richiesta all'utente di 
eseguire classi non sicure. 

Infine abbiamo mostrato come utilizzare le MMA- 
PI per riprodurre file audio e video e le FileCon- 
nection API per accedere al file system. 
D'ora in poi se una mattina avete deciso di dormi- 
re invece di andare a lavoro, anziché svegliarvi per 
mandare un sms al vostro capo scrivendogli "Sto ma- 
le, oggi resto a casa", preparate il messaggio la se- 
ra prima e la mattina dormite pure! 

Vincenzo Viola 
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DAGLI EFFETTI SPECIALI 
AL MOTION DETECTION 

OPENCV 0.9.7 



LA LIBRERIA MULTI PIATTAFORMA 
PER LA RETE 

Di Ace ce ne parla in modo approfon- 
dito Alfredo Marroccelli nel bell'arti- 
colo contenuto in questo stesso nu- 
mero di ioProgrammo. Si tratta di 
una libreria che fornisce al C++ uno 
strato d'astrazione verso il TCP/IP. In 
parole povere consente di program- 
mare applicazioni che fanno un uso 
estensivo delle risorse di rete, co- 
struendo uno strato superiore che fa 
da interfaccia verso il sistema opera- 
tivo. Questo garantisce la massima 
portabilità da un sistema all'altro. Di 
fatto in fase di programmazione sarà 
semplicemente necessario richiama- 
re le funzioni e i metodi esposti da 
ACE, sarà poi ACE ad occuparsi di 
capire quale sistema c'è sotto. 
Directory:/ Ace 

ECLIPSE 3.1.2 

LA PIATTAFORMA UNIVERSALE 
MULTIFUNZIONE 

Sembra un sottotitolo esagerato ed 
eclatante: "La piattaforma universale 
multi/unzione" ed invece Eclipse è 
nato proprio con questo scopo. 




A prima vista sembra un normale 
editor per programmatori Java, anzi 
molto di più che un normale editor, 
visto che ospita una serie di funzio- 
nalità piuttosto avanzate che vanno 
dal code completion alla syntax high- 
lithing al refactoring e che lo stanno 



portando a diventare uno standard 
proprio per Java, tuttavia è anche ve- 
ro che Eclipse è completamente 
estensibile per mezzo di plugin, tan- 
to che può essere utilizzato da pro- 
grammatori PHP come da program- 
matori C++ e persino come frontend 
verso database etc. 
Insomma qualunque tipo di neces- 
sità voi abbiate, Eclipse è in grado di 
aiutarvi. Se poi siete dei programma- 
tori Java rientra in quel ristretto nu- 
mero di software indispensabili per 
gestire rapidamente il vostro lavoro. 
Directory:/ Eclipse 

DEV CPP 4.9.9.2 

LA VERSIONE PIÙ RECENTE 
DELL'AMBIENTE PIÙ USATO 
DAI PROGRAMMATORI C++ 

Dev C++ è pratico, non ha costi, è 
molto funzionale leggero e versatile, 
questo lo rende un tool estremamen- 
te amato dai programmatori C++ e 
che si contrappone nella sua sempli- 
cità a strumenti ben più costosi. 
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È ovviamente dotato di tutte le fun- 
zionalità tipiche di un ambiente di 
programmazione come il sintax 
highliting e il code complexion, ma 
soprattutto è un'indispensabile se 
ritenete di volere o dover program- 
mare in C++. 
Directory:/ DevCPP 



JDK 1.5.0 UPDATE 6 
COni NETBEANS 

LO STRUMENTO INDISPENSABILE 
PER SVILUPPARE IN JAVA 

Se siete sviluppatori Java o avete in- 
tenzione di imparare a programmare 
in Java avete sicuramente bisogno 
del JDK. La versione che vi proponia- 
mo è particolarmente interessante, 
perché oltre al consueto JDK contie- 
ne un bundled una versione di Net- 
Beans, ovvero un ambiente di pro- 
grammazione appositamente stu- 
diato per applicazioni Java. NetBeans 
è piuttosto potente, anche se molto 
pesante. È necessario avere un com- 
puter performante per lavorare in 
tranquillità. E d'altra parte il concor- 
rente "Eclipse" non è certo un mo- 
stro di leggerezza. In ogni caso le ca- 
ratteristiche di Eclipse sono interes- 
santi. Si va dal code completion alla 
sintassi highliting al refactoring. 
Sicuramente è un ottimo editor alter- 
nativo ad Eclipse ed altamente esten- 
dibile grazie ai moduli. 
Directory:/ J2SE 

JASPER 
REPORTS 1.2.0 

UNA LIBRERIA SCRITTA IN JAVA 
PER CREARE REPORT 
PERSONALIZZATI 

Un libreria per generare report in 
grado di inviare il proprio output allo 



O fkdM %. '3L 1»» * 




Northwind Order L 


VimmèmQ* ^An^v^UOftVI 




OE^^^^HèS 








IW9 




wm+*vt**-**> 


lW&\P.™*b»*rtmA 




n=ama 


nomon 




-f^rpr-pi,' 






! Court ;|W{P^ 


LSVFAGE^jVlPAGtl 










la 1 


ThaTs MI 


1 



► 106 /Aprile 2006 



http://www.ioprogrammo.it 



Librerie e Tool di sviluppo ■ T SOFTWARE SUL CD 



schermo, alla stampante o addirittu- 
ra a file in formato PDF, HTML, XLS, 
CSV e e XML. 

Interamente scritta in Java, può facil- 
mente essere utilizzata in un infinità 
di applicazioni, per generare conte- 
nuti dinamici. 
Directory:/ JasperReports 

MRTG 2.13 

MISURAZIONI DI RETE PERFETTE 

Volete sapere quanto consuma in ter- 
mini di banda il vostro WebServer? 
Avete necessità di conoscere quanta 
banda viene consumata in termini di 
accessi FTP? Mrtg è un frontend ver- 
so il servizio SMTP. Consente di mi- 
surare con estrema precisione tutti i 
parametri che caratterizzano il vo- 
stro sistema sia esso un sistema Win- 
dow che Linux. Requisiti fondamen- 
tali per utilizzare a fondo questo 
frontend sono un'installazione di 
Perl funzionante sulla propria mac- 
china e che il servizio Snmp sia atti- 
vo. 
Directory:/ Mrtg 

MYSQL S.O.18 

UNO DEI DB SERVER PIÙ USATI 
AL MONDO 

Se Apache e PHP fanno da supporto 
alla maggior parte delle applicazioni 
che girano oggi su Internet, è anche 
vero che quasi tutte queste applica- 
zioni sfruttano almeno in parte un 
database MySQL come sostegno per 
conservare i dati che manipolano. 
MySQL è estremamente leggero, ve- 
loce, flessibile, inoltre è multipiatta- 
forma. Offre caratteristiche di tutto 
rispetto, che vanno dal supporto alle 
transazione alla ricerca full text, è 
perfettamente integrato con PHP. 
Tutte queste ragioni ne hanno fatto 
un leader per quanto riguarda il set- 
tore dei database. 
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In questo numero oltre alla versione 
4.1.11 ormai consolidata vi presen- 
tiamo anche la nuovissima Beta 5.0.3 
da non utilizzare in ambienti di pro- 
duzione, ma piuttosto intrigante per 
capire da soli qual è la direzione che 
uno dei database più usati al mondo 
sta usando. 
Directory:/ MySQL 

PHP 5.1.2 

IL LINGUAGGIO DI SCRIPTING 
PER IL WEB 

Ormai PHP lo conoscete tutti, e se non lo 
avete mai usato, sicuramente vi sarà capi- 
tato di accedere a qualche sito web svilup- 
pato con PHP Saprete dunque perciò che 
è un linguaggio di scripting particolar- 
mente utilizzato per sviluppare Web 
Application. Incredibilmente potente, fa 
della completezza del linguaggio, della fa- 
cilità di apprendimento, della capacità di 
integrarsi con applicazioni di Dababase i 
suoi punti di forza. 
Directory:/ PHP 

WXWIDGETS 2.6.2 

COMODE LIBRERIE 

PER LO SVILUPPO DI INTERFACCE 

GRAFICHE 

Interessantissime queste librerie, più volte 
le abbiamo utilizzate all'interno dei nostri 
programmi per realizzare degli esempi. Si 
tratta di librerie che consentono la crea- 
zione di interfacce grafiche, possono esse- 
re utilizzate da C++ ma anche da altri lin- 
guaggi come ad esempio Python. La cosa 
estremamente interessante è che con- 
sentono lo sviluppo di applicazioni com- 
pletamente multipiattaforma, sono dispo- 
nibili infatti sia in ambiente *nix che in 
ambiente Windows. Continueremo sicu- 
ramente a parlarne in modo intensivo da 
queste pagine. 
Directory:/ wxWidgets 

PHPMYADMini 2.8.0 

MOLTO PROBABILMENTE 
IL FRONTEND PIÙ USATO 
AL MONDO PER MYSQL 

Ci possono essere un milione di mo- 
tivi per cui usare un'applicazione 
Web come frontend verso MySQL, ad 
esempio quando il vostro provider 
supporta solo la connessione a local- 
host è assolutamente indispensabile. 



PHPMyAdmin tuttavia non è un ripie- 
go a un'interfaccia grafica evoluta, 
anzi la complessità delle funzioni che 
esporta lo rende molto spesso pre- 
feribile a un'interfaccia standalone. 
Directory:/ phpmyadmin 



" 



OPEMCV 

LA LIBRERIA MULTIPIATTAFORMA 
PER LA WEBCAM 

Ce ne parla a lungo Antonino Panella, nel- 
l'articolo che questo mese illustra come 
creare un programma di tiro al bersaglio. 
L'esempio è didattico, male OpenCVsono 
delle librerie opensource che consentono 
di gestire in modo ottimale la webcam. Le 
applicazioni sono infinite, si va dal ricono- 
scimento facciale al motion detection e 
persino ad usi avanzati e futuristici come il 
riconoscimento del labiale. Si tratta di 
librerie estremamente potenti che con- 
sentono di lavorare con le immagini in 
modo sofisticato. Un primo esempio d'uso 
lo trovate in questo numero, ma siamo 
convinti che voi stessi sarete in grado di 
suggerirci impieghi molto fantasioso di 
questo ottimo framework 
Directory: OpenCV 

PRTG TRAFFIC 
GRAPHER 5.2.0.565 

TRAFFICO SOTTO CONTROLLO 

Mrtg lo conoscete tutti, si tratta di un 
software estremamente preciso per deter- 
minare il consumo di banda, di processo- 
re, di memoria di un sistema. MRTG inter- 
roga una macchina usando il protocollo 
SNMP e questo garantisce una resa otti- 
male . MRTG ha degli svantaggi. Si tratta di 
un'applicazione peri che non ha la stessa 
facilità di utilizzo di un'applicazione a 
finestre. Per gli utenti Windows c'è PRTG, 
che tramite una comoda GUI esporta tutte 
le funzionalità classiche di MRTG in modo 
comodo e intuitivo, con tanto di grafici e 
report dettagliati. Molto utile. 
Directory: /Prtg 



http://www.ioprogrammo.it 



Aprile 2006/ 107 ► 



T SOLUZIONI 



SORTING, ALGORITMI 



AVANZATI 



L'ORDINAMENTO DEI DATI È UN'OPERAZIONE CHE RICORRE DI FREQUENTE. 

UN ALGORITMO EFFICIENTE PUÒ QUINDI SEGNARE LA DIFFERENZA TRA UNA BUONA E 

UNA CATTIVA APPLICAZIONE 



Ordinare dati, che siano essi espressi co- 
me: array, liste di puntatori o come re- 
cord di una tabella di database; è forse 
l'attività più diffusa nell'ambito della pro- 
grammazione di computer. La vastissima lette- 
ratura a riguardo ne è una riprova. Certo è che 
l'argomento sorting non si può facilmente li- 
quidare con la sterile enunciazione di uno tra 
tanti metodi negli anni approntati. Sempre più 
spesso capita di fare i conti con situazioni im- 
prevedibili e difficilmente classificabili che ri- 
chiedono l'applicazione personalizzata di al- 
goritmi di ordinamento. Ad esempio, con i da- 
tabase non sempre è sufficiente cliccare il bot- 
toncino presente sul DBMS di turno per ordi- 
nare i dati rispetto ad un attributo. Ne tanto me- 
no si possono facilmente risolvere alcuni problemi 
con semplici query SQL. Per questo primo ap- 
puntamento ci occuperemo della sintetica e 
quasi manualistica descrizione dei metodi più 
efficienti nel ambito del sorting. Potranno es- 
sere un utile supporto per il programmatore. 
Nel prossimo appuntamento affronteremo spe- 
cifici problemi legati ad argomenti come SQL, i 
puntatori oppure la ricerca binaria. 
E' altrettanto vero che i linguaggi moderni di- 
spongono di costrutti ad alto livello per l'ordi- 
namento dei dati, tuttavia per lo scopo didat- 
tico di questa rubrica e per lo spirito di cono- 
scenza che deve animare ogni programmatore, 
in questo numero ci divertiremo proprio a com- 
prendere quali sono i vari algoritmi di ordina- 
mento e quali siano i loro vantaggi e svantaggi 
rispetto alle applicazioni da sviluppare. Questi 
algoritmi sono estremamente datati, ma nel 
tempo nessuno ne ha trovato di migliori, se- 
gnale evidente di come nonostante la tecnolo- 
gia si evolva continuamente rimangono alcuni 
pilastri di base che costituiscono anche quel 
bagaglio di conoscenze che ogni programma- 
tore che voglia affrontare questo mondo con 
professionaità e in modo produttivo deve por- 
tare sempre con se 



HEAP SORT 

Consideriamo il vettore disordinato: 




Per semplicità ad ogni passata la testa dell'insieme 
chiamato heap verrà ricopiata su di un secon- 
do vettore. A rigore tale vettore non è indi- 
spensabile. Inizialmente bisogna costruire l'heap. 
Operazione sviluppata per fasi come mostrato 
nella tabella di seguito (ogni riga rappresenta 
nelle sue prime cinque caselle il vettore e nel- 
l'ultima la fase del processo generativo). Con il 
trattino si indica che al momento la casella non 
contiene valori. Il simbolo asterisco segnala che 
in quella fase il vettore parziale corrisponden- 
te non è un heap. 
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Nella fase 1 viene ricopiato nell'heap il primo 
elemento del vettore. Ovviamente, questo in- 
sieme degenere (poiché costituito da un singo- 
lo numero) è un heap, infatti, rispetta le pro- 
prietà. Successivamente, si aggiunge il secon- 
do numero. Anche il nuovo mini vettore è un 
heap, come si può notare temp[2]>temp[l] . Al 
terzo passaggio, l'aggiunta del nuovo numero 
rende il vettore in fase di costruzione non un 
heap, nella tabella l'evento è segnalato con aste- 
risco. Bisogna quindi scambiare, ottenendo co- 
sì il risultato di fase 4 che è un heap. Lo scambio 
non può produrre situazioni per le quali altri 
elementi dell'insieme non rispettino con la nuo- 
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va configurazione le proprietà dell'heap, poi- 
ché dopo gli scambi le disuguaglianze sono mag- 
giormente verificate. L'aggiunta del quarto ele- 
mento impone un doppio scambio fornendo il 
doppio risultato prima di fase sei e poi di fase set- 
te. In queste ultime fasi il vettore non costitui- 
va heap poiché nel primo caso si presentava 
temp[4]<temp[2] e nel secondo caso 
temp[2]<temp[l]. L'ultimo inserimento, del quin- 
to numero non genera, il ricercato mucchio poi- 
ché non è rispettata la condizione temp[5]>temp[2] 
quindi si procede allo scambio che sancisce l'ul- 
timo passo per la produzione del vettore heap 
(fase 9). Terminata la fase di costruzione bisogna 
procedere con l'estrazione degli elementi dall'heap 
per la generazione del vettore ordinato. Ogni- 
qualvolta si estrae un elemento dal mucchio (il 
primo perché il più piccolo parziale) bisogna 
ricomporre l'heap al vettore rimanente. 



Finché l'heap è vuoto 
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Strutturiamo l'intero algoritmo: 
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HEAP SORT 



Si tratta di un metodo popolare. 
Si basa sul concetto di heap, 
letteralmente mucchio. Un heap è 
un insieme di elementi (al, a2, ..., 
an) parzialmente ordinati. 
L'ordinamento parziale è 
assicurato dalla seguente 
proprietà: 

ai >= ai/2 

per ogni i appartenente 
all'intervallo [1,n] 
con n cardinalità dell'insieme. La 
frazione è intesa come quoziente 



intero 

Realizzare un algoritmo che 
implementi tale metodo significa, 
sulla base di un insieme di numeri 
disordinati, effettuare una 
opportuna permutazione in modo 
che costituiscano un heap, 
estrarre il primo elemento 
dall'heap, considerato che sarà il 
valore più piccolo e ripetere il 
procedimento sul restante 
insieme. Ad ogni passata si 
estrarrà il valore più piccolo che 
permetterà così la costruzione 
finale del vettore ordinato. 



Con riferimento all'esempio esaminiamo il ci- 
clo di ripeti. In questo nuovo prospetto oltre al 
vettore di nome temp che contiene l'heap è pre- 
sentato il target ossia il vettore arr che man ma- 
no viene costruito è al termine risulterà total- 
mente ordinato. 

Dopo aver riportato in arr il primo elemento (il 
più piccolo) bisogna ricomporre l'heap; si pro- 
cede spostando l'ultimo elemento in prima po- 
sizione (fase 3), e applicando nuovamente la re- 
gola. Questa volta però, si ragiona esaminando 
inizialmente il primo elemento, dovrà quindi 
risultare che temp[l]<temp[2] e che 
temp[l]<temp[3]. Ovviamente, se l'heap fosse 
stato più "popolato" si sarebbe reso necessario 
il controllo delle caselle di indice multiplo a 
quelle appena analizzate, ma nel caso in esa- 
me non esistono. Si procede trovando il minimo 
tra i due elementi di indice due e tre ed effet- 
tuando se necessario lo scambio, come si rileva 
nella fase 4. Il risultato parziale ottenuto per co- 
me costruito è un heap, quindi si estrae il primo 
elemento lo si colloca nel target e si itera il pro- 
cedimento. Una possibile implementazione può 
essere quella di seguito proposta. 



void heapsort(int *arr) 
{ int i,j,k,z,q,swh,w,h,im; 



int *temp; 
// array temporaneo 
//contenente l'heap 

bool is_heap; 



// Costruzione heap 



for (i = l; i< = n; i + + ) 



{ temp[i]=arr[i]; 



z=i; 



is_heap=false; 



while ((z>l) && (! is_heap)) 



{ q= z/2; // quoziente 



if (temp[z]<temp[q]) 



{ swh=temp[z]; temp[z]=temp[q]; 



temp[q]=swh; 



} 



else is_heap=true; 



}; 



// ricostruzione del vettore ordinato 
for 0=1; i< = n; i + + ) 
{ arr[i]=temp[l]; 



k=n-i; 



temp[l]=temp[k+l]; 



is_heap=false; 



z=l; 



while ((! is_heap) && (2*z <= k)) 
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{ w = 2*z; h = w+l; 



im = h; 



if (h > k) im=w; 



else if (temp[w] < temp[h]) im=w; 



if (temp[z]>temp[im]) 



{ swh=temp[z]; temp[z]=temp[im]; 



temp[im]=swh; 



z=im; } 



else 



is_heap=true; 



> 



Nel valutare la complessità dell' algoritmo bi- 
sogna tener conto dei due cicli distinti per la 
creazione e ricomposizione dell'heap. I due 
frammenti di codice hanno stessa complessità. 
Ma quanto vale ognuna? Nel caso peggiore bi- 
sogna trasferire un numero dal fondo fino al 
primo elemento lungo indici di posto man ma- 
no dimezzato n, n/2, n/4 fino ad arrivare al pri- 
mo. Questa serie, come gli amanti della mate- 
matica possono confermare, è un logaritmo. 
Essendo il ciclo ripetuto n volte, in definitiva la 
complessità di un singolo stadio è 0(n*log(n)) ed 
in totale, quindi, 0(2*n*log(n)) che può essere 
approssimata a 0(n*log(n)). 



MERGE SORT 

Inizialmente il vettore di n elementi viene divi- 
so in due vettori di n/2 elementi; i due sotto- 
vettori ottenuti vengono ordinati separatamente 
riapplicando il metodo, e successivamente fu- 
si (merge). Ordinare i sottovettori di lunghezza 
n/2 significa dividerli in sottovettori di lunghezza 
n/4 e applicare lo stesso procedimento esposto 
per i sottovettori padre. La chiamata ricorsiva 
al metodo termina quando si perviene a sotto- 
vettori di lunghezza unitaria. Nello sviluppare l'al- 
goritmo e la conseguente codifica C++ si sepa- 
rano le due fasi di ordinamento e di fusione. Le 
due partizioni sono individuate dagli interval- 
li [sx,m] e [m,dx], tali indici sono anche i para- 
metri della funzione. L'attuazione della fusio- 
ne avviene attraverso tre fasi identificate da al- 
trettanti cicli di while. In particolare, il primo 
ciclo effettua il merge vero e proprio, mentre i suc- 
cessivi due, si occupano di gestire i residui a se- 
conda se presenti nella partizione sinistra o in 
quella destra. Il vettore temporaneo temp rico- 
struisce il vettore ordinato come giustapposi- 
zione (fusione) dei due sottovettori. L'ultimo 
ciclo di for si occuperà di ricopiare il risultato, 
vettore temporaneo, nell' intervallo [sx,dx] del 
vettore originario a. 



void merge (int sx, int m, int dx) 



{ int temp[20], i, j, k; 



i=sx; 



j = m + l; 



k=sx; 




// Fusione (merge) dei 
// due vettori ordinati 
while ((i< = m) && (j<=dx)) 



{ if(a[i]<a[j]) 



temp[k] = a[i + + ]; 



else temp[k]=a[j+ + ]; 



k+ + ; 



}; 



// Gestione dei residui 
// (se presenti) sinistri 
while (i< = m) 



{ temp[k]=a[i+ + ]; 



k+ + ; 



}; 



// Gestione dei residui (se presenti) 



sinistri 



while (j< = dx) 



{ temp[k] = a[j + + ]; 



k+ + ; 



}; 



// Ricomposizione del vettore a partire da 



quello temporaneo 



for(i = sx; i<=dx; i + + ) 



a[i]=temp[i]; 



} 



La procedura ricorsiva mergesort prende come 
parametri due variabili sx e dx che indicano ri- 
spettivamente l'estremo sinistro e destro del 
vettore (o in generale della porzione di vettore) 
e ordina la sottosequenza compresa nel sotto- 
vettore delimitato da tali indici. L'ordinamento 
viene fatto dalla sequenza di tre operazioni: or- 
dinamento della partizione sinistra (chiamata al- 
la prima procedura mergesort), ordinamento 
della partizione destra (chiamata alla seconda 
procedura mergesort) e fusione dei due sotto- 



MERCE SORT 



La filosofia del divide et impera 
(frase storica "dividi per 
dominare") è realizzata appieno 
nel metodo di ordinamento 
conosciuto come merge sort. Si 
tratta di iterare il processo di 
partizionamento, ordinamento e 
fusione. Nella fase di 
ordinamento si innesca il 
carattere ricorsivo. 
Ecco come può essere 
schematizzato: 



detsort (sequenza) 

{ se sequenza (è disordinata) 

oppure (più lunga di 1) allora 

{ partiziona in due liste sinistra e 
destra 

detsort(sinistra) 
detsort(destra) 
fondi(sinistra, destra) 
> 
} 
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vettori (chiamata a merge, precedentemente 
descritta). La catena delle chiamate ricorsive a 
mergesort ad un certo punto termina e si esce da 
una di esse, così si ripercorre a ritroso la stessa 
catena, fino ad ottenere il risultato sperato di 
ordinamento. Si esce dalla procedura quando 
risulta falsa la condizione dell'if, ossia quando, 
l'indice sinistro non risulta minore di quello de- 
stro, il che significa che i due estremi si sono in- 
contrati e quindi il sottovettore in esame è di 
lunghezza minima 1. Il valore med indica la me- 
dia dei due estremi, si noti che in C++ essendo 
med un intero, il risultato della divisione è sem- 
pre un numero intero, secondo le regole di ca- 
st proprie del linguaggio, tale operazione produrrà 
quindi, il quoziente. 

void mergesort(int sx, int dx) 
{ int med; 
if (sx<dx) 



{ med = (sx+dx)/2; 



// Chiamate ricorsive 
// per le due partizioni 
// sinistra e destra 



mergesort(sx,med); 



mergesort(med + l,dx); 



// Fusione (merge) delle due 



//partizioni ordinate 



merge(sx,med,dx); 



}; 




È evidente come la procedura merge presenti 
complessità proporzionale a n, poiché si tratta 
di una scansione lineare del vettore. Tale prò- 
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"Fasi del quick sort. Per ogni fase sono specifica- 
ti gli elementi di pivot. Il colore verde indica le 
parti del vettore parzialmente ordinate. Nell'ul- 
tima fase l'intero vettore è ordinato". 

cedura è richiamata log(n) volte. Per compren- 
dere ciò si pensi che ogni volta si divide il vettore 
a metà, quindi si generano partizioni di lun- 
ghezza n/2, n/4, n/8 e così via, il cui numero è 
pari, appunto, a log(n). In definitiva, la com- 



plessità totale del metodo è 0(n*log(n)). Una 
versione efficiente del programma andrebbe 
sviluppata in modo non ricorsivo. 



QUICK SORT 

Supponiamo di avere un vettore di nove numeri 
Bisogna individuare in una prima fase un ele- 
mento mediano. In conformità con la lettera- 
tura sulF argomento chiameremo tale elemen- 
to pivot. Come per il basket è necessario stabi- 
lire un numero che si trovi nel mezzo. Si tratta 
del numero 29. Ora si esaminano gli elementi 
a sinistra e a destra del pivot, a partire dal pri- 
mo per l'insieme uno e dall'ultimo per il se- 
condo. Ci si ferma quando si incontra un ele- 
mento in disordine con il pivot. Nella scansio- 
ne a sinistra quando si incontra il numero 36, 
nella scansione a destra già il primo elemento 
esaminato è oggetto di scambio poiché più pic- 
colo del pivot. Così i due numeri 36 e 10 ven- 
gono scambiati. La fase non è conclusa. Ri- 
prendendo a scorrere la parte sinistra non si in- 
contrano altri elementi più grandi del pivot se 
non il pivot stesso che risulta dal confronto non 
minore di se stesso (essendo appunto uguale) 
quindi soggetto a scambio. A destra invece, il 
numero 18 risulta più piccolo del pivot. I due 
elementi 29 e 18 si scambiano e la prima fase 
termina. Ogni fase si conclude quando gli indi- 
ci che percorrono le due partizioni si incontra- 
no. Nella figura 1 sono riportate tutte le fasi ed 
i rispettivi pivot. Le partizioni sono proposte di 
colore diverso. L'ordinamento parziale è rap- 
presentato in verde. 

Da qui in avanti, in generale, si registrerà una 
certa asimmetria. Come si nota nella fase 1 so- 
no stati individuati due insiemi rispetto al pi- 
vot che 29 (verde) . Nel primo insieme tutti i nu- 
meri sono più piccoli rispetto al pivot, per il se- 
condo sono invece maggiori del pivot. L'asim- 
metria sta nel fatto che gli insiemi hanno ades- 
so (nel caso più generale) grandezze differenti. 
A questo punto bisogna applicare lo stesso me- 
todo alle due liste ottenute. Per la prima il pi- 
vot è 10 mentre per la seconda è 30. Così l'or- 
dinamento si ottiene in stadi successivi. Si evi- 
denzia la natura ricorsiva dell'algoritmo che 
presenta sempre le stesse istruzioni applicate 
a sotto liste sempre più piccole. 
Ecco il codice C++ applicato alla struttura dati 
array. 

void quicksort (int sx, int dx) 
{ int i,j, pivot, comodo; 

i = sx; j = dx; 

// Calcolo del pivot 
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pivot=a[(sx+dx)/2]; 


do 


{ 


// Ricerca a sinistra 


// di valori più 


grandi 


del 


pivot 




while (a[i]<pivot) 


i + + ; 







// Ricerca a destra di valori 
//più piccoli del pivot 
while (pivot<a[j]) j— ; 







// Se necessario ; 


;i scambia 








if (i<=j) 




{ comodo=a[j]; 


a[j] = 


a[i]; 


a[i] = 


=comodo; 


i++; j--; 


} 


} 


while (i<=j); 




// Chiamata ricorsiva alle 


due 


parti 


zioni 




if 


(sx<j) quicksort (sx 


J); 










if (i<dx) quicksort ( 


i,dx); 








} 



Il vettore da ordinare è a, gli indici che scorro- 
no sulle due partizioni destra e sinistra sono ri- 
spettivamente i e j. Il pivot viene calcolato ba- 
nalmente come elemento centrale della se- 
quenza. I due parametri sx e dx sono rispetti- 
vamente l'estremo sinistro e destro delle due 
partizioni 

Ogni iterazione del ciclo gestisce il partiziona- 
mento e lo scambio. Al termine di tale ciclo le due 
partizioni sono parzialmente ordinate. Da no- 
tare le successive chiamate ricorsive rispetto 
alle due partizioni prodotte. L'algoritmo è ancora 
più rapido di quello che risulterà dalla analisi 
di complessità se si considera che le variabili 
più usate, come pivot, i e j, vanno (o possono 
essere esplicitamente tenute) in registri veloci 
o memorie cache. 

La complessità dell'algoritmo è la risultante dei 
contributi dovuti dalla fase di partizionamen- 
to e dal numero di scambi. La prima delle due 
fasi consta di n confronti considerato che bi- 
sogna scandire l'intero array. Per sapere inve- 
ce quanti scambi vengono effettuati è neces- 
sario effettuare un'analisi probabilistica. La pro- 
babilità che si verifichi una condizione di scam- 
bio è (n-pos+l)/n con pos posizione del pivot. 
Quindi, il numero atteso di scambi è pari alla 
somma di tutte le probabilità fratto n; che a se- 
guito di semplificazioni algebriche ed appros- 
simazioni risulta essere n/6. Nel caso fortuna- 
to in cui il pivot produca due partizioni di egua- 
le lunghezza, allora il numero di passi sarà log(n), 
poiché si fa riferimento a partizioni ad ogni pas- 



so pari alla metà delle precedenti. In questa si- 
tuazione il numero di confronti è n*log(n) ed il 
numero di scambi (n/6)*log(n). Il caso miglio- 
re che prevede sempre di selezionare la media- 
na nel processo di partizionamento ha proba- 
bilità bassa pari a 1/n, ad ogni modo il caso me- 
dio non presenta un deterioramento evidente del- 
la complessità dell'algoritmo. Un altro elemento 
importante nella valutazione della complessità 
risiede nel miglioramento delle prestazioni man 
mano che n aumenta. Nel caso peggiore, che 
peraltro si presenta raramente, quando il pivot 
corrisponde sempre ad uno dei due estremi del- 
la partizione, l'algoritmo degenera le sue pre- 
stazioni ad una complessità proporzionale a n2 
(quindi poco quick!). È fondamentale la scelta 
del pivot che nell'algoritmo corrisponde all'e- 
lemento di mezzo. Nulla ci vieta di scegliere un 
qualsiasi altro elemento come il primo o l'ulti- 
mo. Ad ogni modo, test statistici hanno evi- 
denziato un migliore comportamento nella scel- 
ta dell'elemento centrale. Hoare proponeva di 
scegliere il valore casualmente o come valore 
mediano di un campione opportunamente ot- 
tenuto da un altro algoritmo. Così la comples- 
sità nelle situazioni favorevoli rimane presso- 
ché invariata, si migliorano invece, sensibil- 
mente le prestazioni rispetto ai casi peggiori, 
che infondo sono lo spauracchio dell'utilizzatore 
di tale metodo. 



CONCLUSIONI 

La prossima volta affronteremo metodi perso- 
nalizzati di ordinamento per la risoluzione di 
problemi non standard. Vi aspetto. 



Fabio Grimali 



QUICK SORT 



Il nome è dovuto al suo creatore 
C.A.R. Hoare, che sviluppò il 
metodo come miglioramento 
(sostanziale!) del bubble sort. 
L'idea perseguita è di 
sviluppare un metodo che 
minimizzasse il numero di 
scambi a fronte di un aumento 
dell'efficienza. Il grande Nickaus 
Wirth, padre del linguaggio 
Pascal, e soprattutto padre della 
programmazione strutturata, 
nel suo "Algoritmi + strutture 
dati = programmi", individua 
come chiave dell'efficienza del 
quick sort il fatto che gli scambi 
tra i valori nel vettore 




avvengono in generale per 
lunghe distanze. Istruttivo è 
l'esempio nel quale si considera 
un vettore di n elementi 
sistemati esattamente 
nell'ordine inverso. Per ordinarli 
basterebbero solo n/2 scambi, 
ed esattamente quelli che 
coinvolgono il primo con 
l'ultimo elemento, il secondo 
con il penultimo e così via. È 
evidente che solo raramente il 
vettore si presenta in questa 
forma, ma l'esempio ha un 
valore simbolico visto che quick 
sort è una generalizzazione del 
concetto esposto. 
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I migliori testi scelti dalla redazione 



ON LINE 




DNSSTUFF 



possibile persino effettuare un check 
della corretta configurazione 
.http://www.dnsstuff.com/ 
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TRACEROUTE 

— er effettuare il corretto trace di un 
pacchetto TCP/IP. Consente di stabilire 
il percorso effettuato da un pacchetto 
prima che giunga a destinazione. 
http://www.traceroute.net 
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DEVLEAP 

— evLeap è una community di pro- 
fessionisti dello sviluppo che ve- 
de la partecipazione dei maggiori esper- 
ti di programmazione italiana. La mag- 
gior parte dei componenti è infatti oc- 
cupata in attività di formazione per al- 
cune delle maggiori software house 
mondiali. 
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.NET GAME PRO- 
GRAMMING C# 

In questo libro vengono illustrate 
le procedure per sfruttare al mas- 




simo il vostro compilatore .NET 
programmando i giochi con C#. In 
effetti le DirectX 9 sono diretta- 
mente accessibili da .NET allora 
perché non sfruttare le caratteri- 
stiche di un linguaggio ad alto li- 
vello per sviluppare videogiochi ? 
Il libro illustra lo sviluppo di cin- 
que differenti progetti completi, 
ognuno dei quali risolve alcune 
problematiche essenziali e pecu- 
liari di un particolare tipo di vi- 
deogames, in questo modo si for- 
nisce un approccio molto scalabi- 
le che affronta in modo quasi in- 
dipendente la programmazione di 
videogiochi 3D e 2D. Il capitolo fi- 
nale è decisamente innovativo, af- 



fronta infatti la scrittura di un vi- 
deogioco per PocketPC. Gli esem- 
pi sono numerosi e ben curati co- 
sì come è curato ogni aspetto del- 
la programmazione. In definitiva 
un buon libro, certamente utile per 
lo sviluppo di videogiochi ma non 
privo di interesse per chi vuole ac- 
quisire un punto di vista alterna- 
tivo nell'utilizzo del C#. 

Difficoltà: Alta • Autore: David 
Weller, Alexandre Santos Lobao, Hel- 
len Hatton • Editore: Apress • 
ISBN: 1-59059-319-7 •Annodi 
pubblicazione: 2004 • Lingua: 
Inglese • Pagine: 414 • Prezzo: 
€ 44,00 



ACTIVE DIRECTORY 
GUIDA COMPLETA 

Active Directory è una tecnologia 
che porta sulle spalle ormai al- 
meno 4 anni di vita. Tuttavia non 
trova riscontro nelle lan delle piccole 
e medie imprese, viceversa è estre- 
mamente diffusa in lan di grandi 
dimensioni. Il torto di questa tec- 
nologia è di essere complessa al- 
meno quanto utile. In realtà utiliz- 
zare AD all'interno di ogni tipo di 
rete comporterebbe enormi van- 
taggi nella lan. Tutto risulta più 
omogeneo, dalla condivisione del- 
le risorse alla pubblicazione delle 



informazioni alla gestione della si- 
curezza, rimane il tarlo di una cer- 
ta difficoltà iniziale nella com- 
prensione dei concetti di base.. Il li- 
bro è una guida certa, pratica e 
completa alla comprensione dei 
meccanismi della tecnologia Acti- 
ve Directory. Incentrato sullo stu- 
dio di casi reali, lo rende partico- 
larmente utile e pronto da essere 
utilizzato in contesti di produzio- 
ne. 

Difficoltà: Media • Autore: Leone 
Randazzo, Marco Bonatto • Edito- 
re: Mondadori Informatica • ISBN: 



88-04-54023-0 • Anno di pubbli- 
cazione: 2005 • Lingua: Italiana • 
Pagine: 506 • Prezzo: € 40,00 
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AMMINISTRAZIONE 
AVANZATA DI SER- 
VER LINUX 

Linux rappresenta una fetta enor- 
me dei sistemi server installati al 
mondo e come tale più di altri ne- 
cessita di continui cambiamenti che 
orientino i suoi servizi verso un tar- 
get che domanda servizi sempre di 
crescente qualit'. Questa crescente 
complessità della domanda, neces- 
sariamente provoca un innalzamen- 
to della complessità nella gestione 
del sistema. Questo libro affronta uno 
per uno i vari servizi possibili in ambito 
Linux. Non ha certo la pretesa di esau- 
rire tutti i concetti legati a ciascun ser- 



vizio, viceversa fornisce una base teo- 
rica che mette in grado l'utilizzatore 
di gestire un qualunque sistema li- 
nux indipendentemente dalla distri- 




buzione o dal contesto in cui esso è 
installato. Non si tratta di un libro 
completamente pratico, tuttavia for- 
nisce una base di conoscenza indi- 
spensabile per gestire con profitto 
ogni tipo di sistema in modo consa- 
pevole e senza abbandonarsi a ten- 
tativi che si rivelano il più delle volte 
un'arma a doppio taglio. Decisamente 
un'indispensabile 

Difficoltà: Alta • Autore: M.Tar- 
tamella - M.Sajeva - B. Vassallo - 
L Puccio • Editore: Springer • ISBN: 
88-470-0234-6 • Anno di pubbli- 
cazione: 2004 • Lingua: Italiana • 
Pagine: 460 • Prezzo: € 35,00 
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